# FXMacroData Free FX Agent Prompt Library Free prompt templates for FX macro analysis, event-risk planning, pair research, visualization, and quant workflows using the FXMacroData MCP server. Canonical page: https://fxmacrodata.com/prompts MCP endpoint: https://fxmacrodata.com/mcp MCP docs: https://fxmacrodata.com/documentation/mcp-server Prompt count: 19 ## Guardrails - Use FXMacroData MCP tools before model memory for live or historical macro and FX data. - Do not invent missing values; state when FXMacroData returns no data. - Cite announcement_datetime for macro figures and separate facts from interpretation. - Do not provide personalized investment advice, position sizing, trade execution instructions, or guaranteed outcomes. - Label backtests and scenarios as hypothetical research aids. ## Prompts ### MCP Connection Smoke Test - id: mcp-connection-smoke-test - category: getting-started - access: Works without an API key for ping, catalogue, FX rates, calendars, sessions, and USD public rows. - mcp_prompt_name: none - tools: ping, data_catalogue, indicator_query, release_calendar - canonical_url: https://fxmacrodata.com/prompts#mcp-connection-smoke-test Verify that the host can see FXMacroData MCP tools before asking for analysis. Prompt: Use the FXMacroData MCP server at https://fxmacrodata.com/mcp. First call ping. Then call data_catalogue(currency="usd"). If inflation is available, call indicator_query(currency="usd", indicator="inflation", limit=3). Then call release_calendar(currency="usd") for the next few rows. Return a compact connection report with tool names called, whether data was returned, and any access limitations. Do not infer values that did not come back from FXMacroData. Output sections: Connection, Visible Tools, Returned Data, Access Notes Safety note: Use this before pasting a long research request into a new agent host. ### Agent System Instruction - id: agent-system-instruction - category: getting-started - access: Usable in any agent that can call FXMacroData MCP or REST tools. - mcp_prompt_name: none - tools: data_catalogue, indicator_query, release_calendar, forex, market_sessions - canonical_url: https://fxmacrodata.com/prompts#agent-system-instruction Give a general AI agent a stable source hierarchy and safety contract for FX macro work. Prompt: You are an FX macro research assistant using FXMacroData as the source of record. Use FXMacroData MCP tools before model memory whenever the user asks for live, recent, historical, scheduled, or structured macro and FX data. Call data_catalogue before uncertain indicator requests. Use indicator_query for macro rows, release_calendar for upcoming event risk, forex for spot history, market_sessions for trading hours, cot_data for CFTC positioning, and commodities for commodity series. State the currency, indicator, date range, and tool used. Cite announcement_datetime for macro figures. If a tool returns no data, say so plainly. Do not fabricate values. Provide neutral research context, not personalized investment advice, trade instructions, guaranteed outcomes, or position sizing. Output sections: Source Hierarchy, Tool Routing, Citation Rules, Safety Boundary Safety note: Keeps the assistant focused on data-grounded analysis and away from personal advice. ### Data Quality Audit - id: data-quality-audit - category: getting-started - access: Free for public rows; broader audits may require an API key. - mcp_prompt_name: data_quality_audit - tools: data_catalogue, indicator_query, release_calendar - canonical_url: https://fxmacrodata.com/prompts#data-quality-audit Make the agent inspect freshness, source, coverage, and missing-data fields before summarizing. Prompt: Audit FXMacroData coverage for [CURRENCY] [INDICATOR]. Call data_catalogue(currency="[CURRENCY]") to verify the slug. Then call indicator_query(currency="[CURRENCY]", indicator="[INDICATOR]") and release_calendar(currency="[CURRENCY]", indicator="[INDICATOR]"). Inspect mcp_metadata, result.data_quality, latest_available_date, source fields, row count, and any pagination or no-data flags. Return an audit note that separates reliable facts, missing fields, stale data, and follow-up checks. Do not produce market interpretation until the audit section is complete. Output sections: Coverage, Freshness, Source Metadata, Data Gaps, Follow-Up Checks Safety note: Prevents a fluent answer from hiding stale or incomplete data. ### Daily Macro Briefing - id: daily-macro-briefing - category: briefings - access: MCP-native prompt; public for USD recent rows and calendars, paid for broader coverage. - mcp_prompt_name: macro_briefing - tools: data_catalogue, indicator_query, release_calendar - canonical_url: https://fxmacrodata.com/prompts#daily-macro-briefing Create a repeatable one-page macro brief for a single currency. Prompt: Produce a one-page macro briefing for [CURRENCY]. Call data_catalogue first. Then retrieve policy_rate, inflation, unemployment, GDP, and the next scheduled releases with FXMacroData MCP tools. Use only returned values. Cite announcement_datetime for every figure. Keep interpretation neutral and label any missing series. Output sections: Current Stance, Inflation Path, Labor Market, Growth, Next Releases Safety note: Briefing language should be market context, not a recommendation. ### Week-Ahead Macro Plan - id: week-ahead-macro-plan - category: briefings - access: MCP-native prompt; protected task tools may require a key. - mcp_prompt_name: week_ahead_macro_plan - tools: release_risk_score_task, macro_research_pack_task, market_sessions - canonical_url: https://fxmacrodata.com/prompts#week-ahead-macro-plan Build a structured week-ahead plan around a focus FX pair. Prompt: Build a week-ahead macro plan for [BASE]/[QUOTE]. Use FXMacroData release_risk_score_task for the pair, macro_research_pack_task for both currencies using policy_rate as the anchor, and market_sessions for timing. Rank events by relevance, map them to FX sessions, and produce neutral scenarios. Do not present the result as trade advice or a forecast guarantee. Output sections: Highest-Priority Events, Session Timing, Scenarios, Data Gaps Safety note: Scenarios should be conditional and data-grounded. ### Session-Aware Market Plan - id: session-aware-market-plan - category: briefings - access: market_sessions is public; pair data may be public or protected depending on the requested dataset. - mcp_prompt_name: none - tools: market_sessions, release_calendar, forex - canonical_url: https://fxmacrodata.com/prompts#session-aware-market-plan Map macro event timing to Sydney, Tokyo, London, and New York trading sessions. Prompt: Create a session-aware market plan for [BASE]/[QUOTE] today. Call market_sessions() first. Then call release_calendar for both currencies and forex(base="[BASE]", quote="[QUOTE]") for recent spot context. Summarize which sessions overlap with scheduled risk, which data rows were used, and what conditions would make the day unusually event-heavy. Keep the output as a planning memo, not a trade instruction. Output sections: Open Sessions, Scheduled Releases, Spot Context, Planning Notes Safety note: Do not tell the user to trade a session; identify timing and context only. ### FX Pair Analysis - id: fx-pair-analysis - category: pair-analysis - access: MCP-native prompt; some macro and COT calls may require a key. - mcp_prompt_name: pair_analysis - tools: forex, indicator_query, cot_data - canonical_url: https://fxmacrodata.com/prompts#fx-pair-analysis Analyze a pair through spot, technicals, rates, inflation, and positioning. Prompt: Analyze [BASE]/[QUOTE] using FXMacroData. Call forex with SMA/RSI context, policy_rate for both currencies, inflation for both currencies, and cot_data where supported. Return a neutral macro view with the exact dates and values returned by the tools. If COT or non-USD data is unavailable, say so and continue with available public context. Output sections: Spot Context, Rates, Inflation, Positioning, Neutral Macro Bias Safety note: Use 'macro bias' rather than buy/sell instructions. ### FX Pair Risk Check - id: pair-risk-check - category: pair-analysis - access: MCP-native prompt; task tools may require a key. - mcp_prompt_name: pair_risk_check - tools: pair_intel_task, release_risk_score_task, macro_regime_classifier_task - canonical_url: https://fxmacrodata.com/prompts#pair-risk-check Triage the biggest current and scheduled risks for a currency pair. Prompt: Run a risk check for [BASE]/[QUOTE]. Use pair_intel_task, release_risk_score_task, and macro_regime_classifier_task for each leg. Separate current setup from upcoming risk. Explain what data would change the view, and identify missing coverage. Do not provide personalized investment advice, position sizing, or execution instructions. Output sections: Current Setup, Top Upcoming Risks, Regime Divergence, Invalidation Conditions Safety note: Use conditional risk framing rather than directives. ### Carry And Rate Differential Check - id: carry-rate-differential - category: pair-analysis - access: USD and FX spot public; non-USD policy-rate series may require a key. - mcp_prompt_name: none - tools: indicator_query, forex, policy_rate_differential_visual_artifact - canonical_url: https://fxmacrodata.com/prompts#carry-rate-differential Compare policy-rate paths and carry pressure across an FX pair. Prompt: Compare carry and policy-rate pressure for [BASE]/[QUOTE]. Use indicator_query for policy_rate on both currencies and forex for recent spot context. If the host supports MCP Apps, prefer policy_rate_differential_visual_artifact for the chart. Explain the current rate spread, recent direction of the spread, and whether spot has moved with or against the rate backdrop. Use dates and values from FXMacroData only. Output sections: Current Spread, Recent Rate Path, Spot Context, Carry Caveats Safety note: Carry is one input, not a standalone trade recommendation. ### COT Positioning Context - id: cot-positioning-context - category: pair-analysis - access: COT data usually requires authenticated access. - mcp_prompt_name: cot_positioning_context - tools: cot_data, forex, pair_intel_task - canonical_url: https://fxmacrodata.com/prompts#cot-positioning-context Use CFTC positioning as a positioning-extreme overlay for supported currencies. Prompt: Summarize COT positioning context for [CURRENCY] and relate it to [BASE]/[QUOTE]. Call cot_data(currency="[CURRENCY]") and forex(base="[BASE]", quote="[QUOTE]"). Report latest report date, net speculative position, recent changes, and whether positioning appears crowded or light relative to recent history if the response supports that comparison. Label unavailable COT fields clearly. Output sections: Latest Report, Net Positioning, Recent Change, Pair Context, Caveats Safety note: Do not treat COT as a timing signal by itself. ### Central-Bank Rate Decision Brief - id: rate-decision-brief - category: event-risk - access: MCP-native prompt; public for USD recent rows, paid for broader coverage. - mcp_prompt_name: rate_decision_brief - tools: indicator_query, release_calendar - canonical_url: https://fxmacrodata.com/prompts#rate-decision-brief Summarize policy-rate stance, inflation, labor context, and next central-bank meeting timing. Prompt: Produce a central-bank rate-decision brief for [CURRENCY]. Call indicator_query for policy_rate, inflation, and unemployment. Then call release_calendar(currency="[CURRENCY]", indicator="policy_rate") for the next scheduled meeting. Cite announcement_datetime for every figure and never invent unavailable data. Output sections: Current Stance, Inflation Path, Labor Market, Forward Guidance, Next Meeting Date Safety note: Keep the output to data-backed scenarios and context; do not claim to know the decision outcome. ### Pre-Central-Bank Decision Brief - id: pre-central-bank-decision - category: event-risk - access: MCP-native prompt; protected task tools may require a key. - mcp_prompt_name: pre_central_bank_decision_brief - tools: macro_regime_classifier_task, indicator_query, release_calendar, macro_research_pack_task - canonical_url: https://fxmacrodata.com/prompts#pre-central-bank-decision Prepare a decision-preview memo before a rate announcement. Prompt: Prepare a pre-central-bank decision brief for [CURRENCY]. Use macro_regime_classifier_task, policy_rate, inflation, release_calendar for policy_rate, and macro_research_pack_task. Frame scenarios around data and timing. Do not claim to know the decision outcome; do not recommend a trade. Output sections: Market Setup, Regime Classification, Decision Risk, Scenarios, Next Timestamp Safety note: Decision previews must stay scenario-based. ### Post-Release Research Summary - id: post-release-trade-summary - category: event-risk - access: MCP-native prompt; event replay tools may require a key. - mcp_prompt_name: post_release_trade_summary - tools: event_impact_replay_task, macro_research_pack_task, pair_intel_task - canonical_url: https://fxmacrodata.com/prompts#post-release-trade-summary Summarize what changed after a macro release without overstating causality. Prompt: Write a post-release research summary for [CURRENCY] [INDICATOR] using [BASE]/[QUOTE] as market context. Use event_impact_replay_task, macro_research_pack_task, and pair_intel_task. State what printed, how it compared with recent context, what the pair did around the event if available, and what remains uncertain. Use announcement_datetime and avoid claiming a single-cause market move unless the returned data directly supports it. Output sections: What Printed, Prior Context, Pair Context, Uncertainties, Next Watch Safety note: Avoid causal overreach; label context as context. ### Release Risk Ladder - id: release-risk-ladder - category: event-risk - access: Calendars are public; pair-aware scoring may require paid access. - mcp_prompt_name: release_risk_ladder - tools: release_calendar, release_risk_score_task, market_sessions - canonical_url: https://fxmacrodata.com/prompts#release-risk-ladder Rank upcoming releases for a pair and tie them to trading-session timing. Prompt: Build a release-risk ladder for [BASE]/[QUOTE] over the next [N] scheduled events. Call release_calendar for both currencies. If available, call release_risk_score_task(base="[BASE]", quote="[QUOTE]"). Use market_sessions to map release timing to sessions. Return a ranked list with timestamp, currency, indicator, why it matters, and what data would reduce uncertainty. Output sections: Ranked Events, Session Mapping, Why It Matters, Data Gaps Safety note: Ranking event risk is not the same as predicting price direction. ### Known-At-Time Backtest Check - id: known-at-time-check - category: event-risk - access: Point-in-time task workflows generally require authenticated access. - mcp_prompt_name: known_at_time_backtest_check - tools: known_at_time_task, indicator_query - canonical_url: https://fxmacrodata.com/prompts#known-at-time-check Prevent lookahead bias before an agent writes a strategy note or backtest. Prompt: Check what FXMacroData would have known about [CURRENCY] [INDICATOR] as of [AS_OF_DATE]. Use known_at_time_task(currency="[CURRENCY]", indicator="[INDICATOR]", as_of="[AS_OF_DATE]"). Compare the result to a normal indicator_query only after the known-at-time slice is shown. Explain which rows were market-visible by the as-of timestamp and which rows must be excluded from any backtest. Output sections: As-Of Context, Visible Rows, Excluded Rows, Backtest Rule Safety note: Never use future-released rows in historical reasoning. ### Event-Gated Backtest Brief - id: event-gated-backtest - category: quant-workflows - access: Backtest task workflows require authenticated access. - mcp_prompt_name: event_gated_backtest_brief - tools: fx_backtest_task, release_calendar, known_at_time_task - canonical_url: https://fxmacrodata.com/prompts#event-gated-backtest Ask an agent to test a simple FX rule with macro release windows instead of hand-waving. Prompt: Create an event-gated backtest brief for [BASE]/[QUOTE] from [START_DATE] to [END_DATE]. Use fx_backtest_task with strategy="carry_momentum", event_gated=true, event_window_days=1, and realistic transaction_cost_bps. Use release_calendar and known_at_time_task only where needed to explain timing. Report assumptions, sample size, metrics, drawdowns, and failure modes. Label all results as hypothetical research, not live performance or investment advice. Output sections: Assumptions, Metrics, Event Gate Impact, Failure Modes, Research Caveats Safety note: Hypothetical backtests are research aids, not performance promises. ### Portfolio Event-Risk Scan - id: portfolio-event-risk-scan - category: quant-workflows - access: Portfolio risk workflows require authenticated access. - mcp_prompt_name: portfolio_event_risk_scan - tools: portfolio_risk_engine_task, release_risk_score_task, market_sessions - canonical_url: https://fxmacrodata.com/prompts#portfolio-event-risk-scan Scan a small FX book for scheduled macro concentration and stress exposure. Prompt: Scan this FX position list for macro event risk using FXMacroData: [POSITIONS_JSON]. Use portfolio_risk_engine_task with a clear stress_shock_pct and horizon_events. If needed, use release_risk_score_task for the highest-risk pairs and market_sessions for timing. Return concentration, upcoming event exposure, stress assumptions, and monitoring priorities. Do not recommend changes to the user's actual portfolio. Output sections: Positions Parsed, Concentration, Upcoming Event Exposure, Stress Assumptions, Monitoring Priorities Safety note: Describe risks; do not tell the user to add, reduce, or close positions. ### Commodity FX Context - id: commodity-fx-context - category: quant-workflows - access: Commodity tools usually require authenticated access. - mcp_prompt_name: commodity_fx_context - tools: commodities, commodities_visual_artifact, forex, indicator_query - canonical_url: https://fxmacrodata.com/prompts#commodity-fx-context Connect commodity moves to commodity-sensitive FX pairs without using third-party runtime data. Prompt: Analyze commodity context for [BASE]/[QUOTE] using FXMacroData only. Call commodities(indicator="[COMMODITY]") and forex(base="[BASE]", quote="[QUOTE]"). If relevant, call indicator_query for terms_of_trade, commodity_price_index, inflation, or policy_rate where available. Explain the commodity path, pair context, and macro channels. Do not use external market-data providers. Output sections: Commodity Path, Pair Context, Macro Channels, Data Limits Safety note: Treat commodity linkage as context, not deterministic causality. ### Visualize Macro Series - id: visualize-macro-series - category: quant-workflows - access: MCP-native prompt; visual artifact tools may require a key. - mcp_prompt_name: visualize_macro_series - tools: indicator_visual_artifact, forex_visual_artifact, commodities_visual_artifact, cot_visual_artifact - canonical_url: https://fxmacrodata.com/prompts#visualize-macro-series Force chart requests toward MCP Apps visual artifacts when the host can render them. Prompt: Visualize this FXMacroData request: [REQUEST]. If the host supports MCP Apps, prefer the relevant visual artifact tool for indicators, FX, commodities, or COT. Return the chart plus a short interpretation that names the tool, date range, latest value, and any stale or missing data flags. If the host cannot render the app, return a compact text fallback. Output sections: Chart, Latest Value, Trend, Data Quality, Fallback Safety note: A chart is a visual summary, not a trade signal.