# FXMacroData — Agent Tool Manifest

> Optimized for autonomous agent tool selection (MCP, OpenAPI, LangChain, smolagents).
> For a long-form human/LLM index see https://fxmacrodata.com/llms.txt.

MCP endpoint: https://mcp.fxmacrodata.com
MCP compatibility endpoint: https://fxmacrodata.com/mcp
OpenAPI: https://api.fxmacrodata.com/openapi.json
MCP discovery: https://fxmacrodata.com/.well-known/mcp.json
Agent discovery: https://fxmacrodata.com/.well-known/agent.json
AI agent install guide: https://fxmacrodata.com/agents/install
Prompt library: https://fxmacrodata.com/prompts
Prompt catalog JSON: https://fxmacrodata.com/prompt-library.json
Prompt catalog text: https://fxmacrodata.com/llms-prompts.txt
MCP Registry name: com.fxmacrodata/fxmacrodata
MCP Registry manifest: https://github.com/fxmacrodata/fxmacrodata/blob/main/api/server.json
ChatGPT app/action landing page: https://fxmacrodata.com/chatgpt
Claude one-click connector: https://claude.ai/connectors/add?url=https%3A%2F%2Fmcp.fxmacrodata.com&name=FXMacroData
Claude compatibility connector: https://claude.ai/connectors/add?url=https%3A%2F%2Ffxmacrodata.com%2Fmcp&name=FXMacroData
Auth: OAuth 2.1 PKCE (preferred) OR `?api_key=YOUR_API_KEY` query parameter on every request.
For MCP access: free users get USD table data (indicator_query) only; MCP visuals/analytics tools and non-USD tooling require a paid key.
For API endpoints: USD endpoints, /forex, /calendar, /data_catalogue are PUBLIC (no key). Non-USD indicators, /cot, /commodities require a key.

Last updated: 2026-07-10.

## Tools (MCP)

Each line: `tool_name — one-line use case. (auth)`

- `ping` — health check; only call if other tools fail unexpectedly. (public)
- `subscribe_for_mcp_access()` — returns a direct subscribe/checkout CTA when MCP premium tools are locked. (public)
- `data_catalogue(currency)` — ALWAYS call first; returns valid indicator slugs for a currency. (public)
- `release_calendar(currency, indicator?)` — next scheduled release dates. (public)
- `forex(base, quote, start_date?, end_date?, indicators?)` — daily ECB spot rates + optional technicals (SMA/EMA/RSI/Bollinger/MACD). (public)
- `indicator_query(currency, indicator, start_date?, end_date?, slug?)` — historical macro time series (CPI, GDP, policy_rate, etc.). Accepts compound `slug="usd:cpi"`. (usd: public; others: api_key)
- `indicator_visual_artifact(currency, indicator, ...)` — same payload + MCP Apps chart widget. (subscriber)
- `indicator_intel_task(currency, indicator, start_date?, end_date?)` — chart-ready series + derived analysis + next release context. (subscriber)
- `pair_intel_task(base, quote, start_date?, end_date?)` — policy-rate spread, spot context, and release timing for an FX pair. (subscriber)
- `macro_heatmap_task(currencies, indicators, start_date?, end_date?)` — cross-currency heatmap for latest/change/z-score exploration. (subscriber)
- `policy_scenario_modeler_task(base, quote, shock_leg?, shock_bps?, elasticity_per_100bps?, start_date?, end_date?)` — what-if policy spread and spot scenario modeling. (subscriber)
- `macro_war_room_task(base?, quote?, currency?, indicator?, start_date?, end_date?)` — multi-panel market cockpit with sessions, release queue, pair context, and generated alerts. (subscriber)
- `event_impact_replay_task(currency, indicator, base?, quote?, lookback_events?, start_date?, end_date?)` — point-in-time replay linking announcement timeline to FX context. (subscriber)
- `quant_scenario_lab_task(base, quote, shock_leg?, shock_bps?, elasticity_per_100bps?, annualized_volatility_pct?, horizon_days?, start_date?, end_date?)` — quant-style scenario distribution with stress percentiles and horizon assumptions. (subscriber)
- `known_at_time_task(currency, indicator, as_of, start_date?, end_date?)` — point-in-time safe slice using `announcement_datetime` cutoff. (subscriber)
- `macro_regime_classifier_task(currency, start_date?, end_date?)` — explainable hawkish/dovish, inflation, growth, and labor regime labels. (subscriber)
- `release_risk_score_task(base, quote, horizon_events?)` — pair-aware upcoming release prioritization. (subscriber)
- `portfolio_risk_engine_task(positions_json, stress_shock_pct?, horizon_events?)` — multi-position FX risk engine with concentration and event-at-risk ranking. (subscriber)
- `fx_trade_setup_task(base, quote, horizon_events?, include_cot?)` — trader-ready pair setup with directional bias, catalysts, execution context, and invalidation notes. (subscriber)
- `fx_backtest_task(base, quote, start_date?, end_date?, strategy?, momentum_lookback?, transaction_cost_bps?, initial_capital?, event_gated?, event_window_days?)` — rule-based historical backtest with metrics, benchmark, and equity curve; supports release-window event gating. (subscriber)
- `macro_research_pack_task(currency, indicator, base?, quote?, start_date?, end_date?)` — canonical research payload for persistent hosts. (subscriber)
- `market_sessions(at?)` — which FX sessions are open right now. (public)
- `cot_data(currency, start_date?, end_date?)` — weekly CFTC COT speculator positioning. (api_key)
- `commodities(indicator, start_date?, end_date?)` — historical commodity prices. (api_key)

## Prompts (MCP `prompts/list`)

- `macro_briefing(currency)` — one-page macro briefing.
- `rate_decision_brief(currency)` — central-bank decision-day brief.
- `pair_analysis(base, quote)` — FX-pair multi-factor view.
- `pre_central_bank_decision_brief(currency)` — persistent decision-preview workflow.
- `post_release_trade_summary(currency, indicator, base, quote)` — event replay plus pair-impact workflow.
- `pair_risk_check(base, quote)` — pair risk triage workflow.
- `week_ahead_macro_plan(base, quote)` — weekly planning workflow for persistent hosts.
- `data_quality_audit(currency, indicator)` — freshness, provenance, row-count, and missing-data audit.
- `release_risk_ladder(base, quote)` — upcoming release ranking mapped to market sessions.
- `known_at_time_backtest_check(currency, indicator, as_of)` — point-in-time backtest guardrail.
- `event_gated_backtest_brief(base, quote, start_date, end_date)` — hypothetical event-gated strategy research brief.
- `portfolio_event_risk_scan(positions_json)` — scheduled macro risk scan for FX position lists.
- `cot_positioning_context(currency, base, quote)` — CFTC positioning overlay for pair research.
- `commodity_fx_context(commodity, base, quote)` — commodity-sensitive FX context workflow.
- `visualize_macro_series(request)` — route chart, plot, and visual requests to MCP Apps visual artifact tools where supported.

## Free prompt library

Use https://fxmacrodata.com/prompts for copyable prompt cards and guardrails.
Use https://fxmacrodata.com/prompt-library.json for machine-readable prompt metadata.
Use https://fxmacrodata.com/llms-prompts.txt for a plain-text prompt catalog.

Core safety boundary for all prompt-library workflows:

- Use FXMacroData MCP tools before model memory for live or historical macro and FX data.
- Never 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, execution instructions, or guaranteed outcomes.
- Label backtests and scenarios as hypothetical research aids.

## Recommended call order

1. `data_catalogue(currency)` to discover valid `indicator` slugs.
2. `indicator_query(currency, indicator)` for time series.
3. `release_calendar(currency)` to see the NEXT print.
4. `forex(base, quote)` for spot + technicals.
5. `cot_data(currency)` for speculator positioning.
6. `commodities(indicator)` for energy/metals.
7. `market_sessions()` for trading-hour context.
8. `indicator_intel_task(currency, indicator)` for explain-first app-ready indicator analysis.
9. `pair_intel_task(base, quote)` for pair-level carry and release context.
10. `macro_heatmap_task(currencies, indicators)` for cross-market comparison.
11. `policy_scenario_modeler_task(base, quote)` for what-if scenario modeling.
12. `macro_war_room_task(base, quote, currency, indicator)` for a live macro cockpit view.
13. `event_impact_replay_task(currency, indicator, base, quote)` for event-to-market replay.
14. `quant_scenario_lab_task(base, quote)` for scenario distribution and stress-band analysis.
15. `known_at_time_task(currency, indicator, as_of)` for point-in-time integrity before backtest-style reasoning.
16. `macro_regime_classifier_task(currency)` for explainable regime labeling.
17. `release_risk_score_task(base, quote)` for pair-aware event prioritization.
18. `portfolio_risk_engine_task(positions_json, stress_shock_pct, horizon_events)` to score concentration, stress exposure, and event-at-risk across positions.
19. `fx_trade_setup_task(base, quote)` for a trader-facing setup object with bias, catalysts, and execution notes.
20. `fx_backtest_task(base, quote, start_date, end_date, event_gated, event_window_days)` to validate strategy assumptions against historical spot behavior and optional release-window gating.
21. `macro_research_pack_task(currency, indicator, base, quote)` for a persistent host's canonical context block.

## Parameter conventions

- All currency codes: 3-letter ISO, case-insensitive. Server lowercases.
- All dates: `YYYY-MM-DD` (preferred) or ISO-8601 datetime. Date-only fields default the time to 00:00 UTC.
- Every returned row carries an `announcement_datetime` (the moment the value was first published) — use this for point-in-time integrity in backtests.

## Supported currencies (18)

USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, NOK, SEK, DKK, PLN, SGD, HKD, BRL, MXN, KRW, CNY.
(CNY data is currently degraded; see /data-coverage for live freshness.)

## Common indicator slugs

policy_rate, inflation, unemployment, gdp, nfp, pce, ppi, retail_sales, trade_balance, current_account, money_supply_m2, government_bond_2y, government_bond_10y.
Slugs vary per currency — `data_catalogue(currency)` is authoritative.

## Integration snippets

### Claude Desktop / OpenCode / Cline / Cursor (OAuth preferred)
Use the bare URL when the client supports OAuth/PKCE and Dynamic Client Registration.
Existing clients configured with `https://fxmacrodata.com/mcp` can keep using that compatibility endpoint.

```json
{
  "mcpServers": {
    "fxmacrodata": {
      "type": "http",
      "url": "https://mcp.fxmacrodata.com"
    }
  }
}
```

### Claude Desktop / OpenCode / Cline / Cursor (API-key fallback)
```json
{
  "mcpServers": {
    "fxmacrodata": {
      "type": "http",
      "url": "https://mcp.fxmacrodata.com?api_key=YOUR_API_KEY"
    }
  }
}
```

### Continue.dev (`config.yaml`)
```yaml
mcpServers:
  - name: fxmacrodata
    type: http
    url: https://mcp.fxmacrodata.com
```

API-key fallback:

```yaml
mcpServers:
  - name: fxmacrodata
    url: https://mcp.fxmacrodata.com?api_key=YOUR_API_KEY
```

### LangChain / smolagents (OpenAPI tools)
Point at `https://api.fxmacrodata.com/openapi.json` and use `?api_key=` query auth.

### Goose extension (`extension.yaml`)
```yaml
- type: streamable_http
  name: fxmacrodata
  uri: https://mcp.fxmacrodata.com
```

API-key fallback:

```yaml
- type: streamable_http
  name: fxmacrodata
  uri: https://mcp.fxmacrodata.com?api_key=YOUR_API_KEY
```

## Hard rules for agents

- Never invent macro values. If the API returns empty, say so.
- Always cite `announcement_datetime` for every figure surfaced to the user.
- Prefer `indicator_query` over `indicator_visual_artifact` unless the user explicitly asks to plot/chart/visualize.
- Treat `data_catalogue` results as the authoritative slug list for a currency; do not guess.

## Discovery

- MCP server config: https://fxmacrodata.com/.well-known/mcp.json
- MCP compatibility endpoint: https://fxmacrodata.com/mcp
- AI agent install guide: https://fxmacrodata.com/agents/install
- MCP Registry manifest: https://github.com/fxmacrodata/fxmacrodata/blob/main/api/server.json
- MCP Registry name: com.fxmacrodata/fxmacrodata
- Claude connector install: https://claude.ai/connectors/add?url=https%3A%2F%2Fmcp.fxmacrodata.com&name=FXMacroData
- Claude compatibility connector install: https://claude.ai/connectors/add?url=https%3A%2F%2Ffxmacrodata.com%2Fmcp&name=FXMacroData
- ChatGPT landing page: https://fxmacrodata.com/chatgpt
- Prompt library: https://fxmacrodata.com/prompts
- Prompt catalog JSON: https://fxmacrodata.com/prompt-library.json
- ChatGPT plugin manifest: https://fxmacrodata.com/.well-known/ai-plugin.json
- OpenAPI: https://api.fxmacrodata.com/openapi.json
- OAuth metadata: https://fxmacrodata.com/.well-known/oauth-authorization-server
- OAuth protected resource metadata: https://fxmacrodata.com/.well-known/oauth-protected-resource
- Concise LLM index: https://fxmacrodata.com/llms.txt
- Full LLM index: https://fxmacrodata.com/llms-full.txt