Live MCP · Streamable HTTP OAuth 2.0 + PKCE

FXMacroData MCP Server

Give your AI assistant a live macro data terminal: official-source indicators, release calendars, FX spot context, COT, commodities, chart apps, and task-ready research workflows inside the tools you already use.

https://fxmacrodata.com/mcp

30 tools available

22 REST routes

First API call

Quick Request

Start with a live announcement endpoint. Authentication stays in the api_key query parameter for direct browser and script testing.

EUR inflation example GET /api/v1/announcements/eur/inflation

curl "https://fxmacrodata.com/api/v1/announcements/eur/inflation?api_key=YOUR_API_KEY"

import requests

url = "https://fxmacrodata.com/api/v1/announcements/eur/inflation"
params = {"api_key": "YOUR_API_KEY"}
response = requests.get(url, params=params, timeout=20)
print(response.json())

const url = "https://fxmacrodata.com/api/v1/announcements/eur/inflation?api_key=YOUR_API_KEY";
const response = await fetch(url);
const data = await response.json();

Choose Your MCP Access Path

Start with the free public MCP surface for USD lookup and discovery. Add paid access when your assistant needs non-USD indicators, full USD history, COT, commodities, task workflows, or protected data calls through OAuth or /mcp?api_key=YOUR_API_KEY.

Free

USD recent data, FX rates, catalogue, calendar, sessions, and client testing without an API key.

Individual

$25/mo

Full trader access with a 14-day trial for protected MCP tools, API rows, dashboards, and AI research workflows.

Start trial

Startup

Team

Use MCP, REST, widgets, and redistribution-friendly terms when FXMacroData is part of a client-facing product.

View startup plan

Enterprise

Custom

Private licensing, custom privacy posture, audit expectations, and platform usage patterns for larger desks.

Why Connect FXMacroData MCP

FXMacroData MCP turns a general-purpose AI assistant into a macro-aware research agent. Instead of asking a model to guess from stale training data, the assistant can call live tools for policy rates, inflation, GDP, labor data, release calendars, FX rates, COT positioning, commodities, and official dataset families. The result is a conversation that can cite actual data rows, use release timestamps, and keep the analysis grounded in the same production API that powers the FXMacroData dashboard.

For discretionary FX research

Ask for a EUR/USD macro setup, compare policy-rate differentials, review the next event risks, or build a pre-central-bank briefing without leaving Claude, ChatGPT, Cursor, VS Code, or your preferred agent host.

For quant and systematic workflows

Use point-in-time release timestamps, backtest tasks, event-gated filters, portfolio risk scoring, and reusable research packs to keep exploratory notebooks and agent-generated analysis aligned with live macro data.

For coding agents

Give Cursor, Continue, Cline, Windsurf, Replit Agent, Zed, Kiro, and JetBrains a single remote MCP endpoint that can discover indicators, validate examples, and generate macro-aware app or notebook code.

For chart-first answers

Compatible MCP Apps hosts can render interactive chart resources for indicator series, FX rates, policy-rate comparisons, release calendars, heatmaps, scenario models, event replays, and quant labs.

Choose the Right MCP Surface

Use data tools for exact facts

Call data_catalogue, indicator_query, forex, and release_calendar when you need rows, timestamps, JSON, tables, or exact values.

Best prompt: "Get USD inflation from 2024-01-01 to 2025-01-01."

Use Apps for visual analysis

Call visual artifact tools when the answer should include an interactive chart, release-calendar view, heatmap, scenario model, or event replay inside the chat.

Best prompt: "Show me a chart of AUD policy rates since 2020."

Use tasks for research workflows

Call task tools when the assistant should assemble several data sources into a decision-ready output, such as a trade setup, risk score, backtest, or research pack.

Best prompt: "Build a EUR/USD trade setup with catalysts and invalidation notes."

Use prompts for repeatable routines

Prompt-aware hosts can discover curated workflows for macro briefings, pair risk checks, post-release summaries, week-ahead plans, and chart routing.

Best prompt: "Run the FX pair risk check prompt for EUR/USD."

Open the free prompt library

Trust and Freshness Metadata

FXMacroData MCP responses include a compact mcp_metadata block on the response and, for source-backed datasets, result.data_quality. Check these fields before using a result in a trade note, backtest, alert, notebook, or automated research workflow.

Freshness

Inspect latest_available_date, last_updated, data_lag_days, and is_stale before treating data as current.

Provenance

Use source_type, source_name, is_proxy, is_derived, and is_fallback to label source quality.

Coverage

Start with data_catalogue using include_coverage=true; review coverage_summary and row-level coverage_quality.

Backtest safety

For point-in-time workflows, check point_in_time_safe, has_announcement_datetime, row_count_before_pagination, and returned_count.

{ "mcp_metadata": { "source_type": "official", "latest_available_date": "2026-06-19", "data_lag_days": 3, "is_proxy": false, "is_derived": false, "is_fallback": false, "point_in_time_safe": true, "row_count_before_pagination": 250, "returned_count": 100 }, "result": { "data_quality": { "is_official": true, "is_proxy": false, "is_fallback": false, "is_stale": false, "has_announcement_datetime": true, "point_in_time_safe": true, "latest_available_date": "2026-06-19", "source_type": "official", "source_name": "BLS", "row_count": 100, "quality_scope": "full_result" } } }

Agent rule

If a required freshness, source, or coverage field is missing, continue only as exploratory context and state that provenance or freshness is unknown. Do not silently treat a valid tool response as analysis-ready.

Indicator Pagination Workflow

MCP indicator tools use the same REST pagination contract as /api/v1/announcements/{currency}/{indicator}. For long histories, request a broad date window once and walk pages with pagination.next_offset; do not retry arbitrary shorter windows unless the user asked for a specific sub-period.

1. Discover coverage

data_catalogue(currency="nzd", include_coverage=true, include_capabilities=true)

Use catalogue coverage dates, capabilities, exact slugs, and mcp_metadata.coverage_summary before querying a sparse indicator.

2. Query one page

indicator_query(currency="nzd", indicator="gov_bond_10y", limit=100, offset=0)

Use page or offset; page takes precedence.

3. Continue or diagnose

offset = result.pagination.next_offset

Check pagination.page_includes_latest_available. Empty valid windows return NO_DATA_IN_REQUESTED_WINDOW with coverage dates.

Quick Connect

Start with the bare MCP URL when your host supports OAuth. Use the API-key URL only when the host cannot complete an OAuth flow or when you want a simple server-to-agent connection for a private workspace.

Claude (Web & Desktop)

claude.ai — remote MCP connector

1

Open Claude → Settings → Connectors

Click Add MCP Server and select Remote.
2

Enter the server URL

https://fxmacrodata.com/mcp
3

Start using it

Free access supports USD table data (indicator_query) with no key. For MCP app visuals, analytics tools, and non-USD coverage, use a paid key or OAuth. Claude should discover OAuth automatically from the MCP URL. If a Claude flow asks for an OAuth client ID and secret, use the FXMacroData-issued values for that host. As a direct fallback, use https://fxmacrodata.com/mcp?api_key=YOUR_KEY.
4

Verify the connection

In a new chat, ask: "Run the FXMacroData ping tool", "Show me available USD indicators", "What sessions are open right now?", or "Run subscribe_for_mcp_access".

VS Code / GitHub Copilot

Add MCP server via settings.json or Copilot panel

1

Open Command Palette → MCP: Add Server

Or edit .vscode/mcp.json directly.

Add this configuration

VS Code MCP configuration uses servers for HTTP server entries.

{
  "servers": {
    "fxmacrodata": {
      "type": "http",
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

3

Start using it

Works immediately for free USD table data. VS Code can use OAuth with PKCE and no client secret, bearer tokens, or a direct API-key fallback. For multi-currency access plus MCP charts and analytics tools, either complete the OAuth prompt or append ?api_key=YOUR_KEY to the URL.

Codex in VS Code

Configure Codex CLI / IDE extension MCP servers in ~/.codex/config.toml

1

Open Codex MCP settings

In the Codex IDE extension, open the gear menu, choose MCP settings, then Open config.toml. The Codex CLI and the Codex VS Code extension share this file.
2
Add the FXMacroData server
```
[apps._default]
enabled = true

[mcp_servers.fxmacrodata]
enabled = true
url = "https://fxmacrodata.com/mcp"
```
The [apps._default] block enables ChatGPT Apps/connectors support in Codex builds that expose the feature. The public URL works for free USD table data and OAuth-capable Codex sessions.
3
Use the subscribed URL when OAuth is not available
```
[apps._default]
enabled = true

[mcp_servers.fxmacrodata]
enabled = true
url = "https://fxmacrodata.com/mcp?api_key=YOUR_KEY"
```
Use a paid FXMacroData API key for non-USD indicators, full historical archives, COT, commodities, MCP charts, and analytical tools. Keep real keys in your local Codex config or a private secret manager, never in source control.
4

Reload Codex and verify

Reload VS Code or start a new Codex chat so the MCP server list is refreshed. In the Codex CLI/TUI, run /mcp. Then ask: "Use the fxmacrodata MCP to show the AUD release calendar."

Codex note

Codex does not read VS Code's .vscode/mcp.json as its primary MCP source. Put Codex MCP servers in ~/.codex/config.toml or a trusted project .codex/config.toml.

Visual rendering depends on the host

FXMacroData returns MCP Apps resources such as ui://fxmacrodata/release-calendar.html. App-capable Codex/ChatGPT hosts can mount those resources inline. If your host only shows JSON, markdown, or a resource_link, the MCP data path is working but that host/session is not mounting Apps UI resources.

Consumer experience

After Codex reloads, use natural language prompts such as "show the AUD release calendar" or "list AUD indicators". Codex should call FXMacroData MCP tools directly. You should not need to run curl, PowerShell, or hand-written JSON-RPC unless you are debugging a custom integration.

◈

Cursor

Settings → MCP → Add new global MCP server

1

Open Cursor Settings → MCP

Click Add new global MCP server.
2
Add to ~/.cursor/mcp.json
```
{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}
```
Cursor uses mcpServers. Cursor can use OAuth discovery when the host supports it. As a direct fallback, append ?api_key=YOUR_KEY to the URL.
3

Reload and verify

Restart Cursor and ask the Composer: "What macro indicators are available for USD?"

ChatGPT (Apps SDK)

chatgpt.com — MCP connector & interactive chart widget

Requires ChatGPT Plus, Pro, Business, Enterprise, or Education and developer mode enabled.

1

Enable developer mode

In ChatGPT: Settings → Apps & Connectors → Advanced settings → toggle Developer mode on.
2

Create a connector

Go to Settings → Connectors → Create. Set the name to FXMacroData and enter the connector URL:

https://fxmacrodata.com/mcp

Works without a key for free USD table data. Compatible auth paths include OAuth discovery, bearer tokens, or direct API-key fallback via ?api_key=YOUR_KEY — get your key from the API management page to unlock MCP visuals and analytics.
3
Use FXMacroData in a conversation

Open a new chat, click the + button → More, and select FXMacroData. Then try a prompt:
- "Show me a chart of US inflation since 2020."
- "What indicators are available for the Euro area?"
- "What FX sessions are open right now?"
4

View the interactive app widget

Ask for "Show me the AUD release calendar" or "Show me a chart of AUD policy rate history". In app-capable ChatGPT sessions, the response should mount the returned MCP Apps resource inline after OAuth or paid-key authentication. If the response only shows JSON or markdown, the connector is reachable but the host has not mounted the app resource.

ChatGPT Apps directory

FXMacroData is available in the ChatGPT Apps directory once the app is publicly listed. You can also connect directly via the MCP URL above without waiting for the listing.

Mistral Le Chat

chat.mistral.ai — remote MCP connector

1

Open Le Chat settings

Go to Settings → Connectors and choose to add a custom MCP server.

Use this connector JSON

{
  "name": "FXMacroData",
  "url": "https://fxmacrodata.com/mcp",
  "transport": "http"
}

3

Authenticate for full coverage

Free access supports USD table data only. For non-USD series and MCP visual/analytics tools, use an authenticated connector URL such as https://fxmacrodata.com/mcp?api_key=YOUR_KEY.
4

Run quick checks

Try: "Run ping", "Show USD policy_rate history", and "What FX sessions are open now?".

OpenAI Responses API + Agents SDK

openai-agents · remote MCP server · Streamable HTTP

1

Install the Agents SDK

pip install openai-agents
2

Register the FXMacroData MCP server

from agents.mcp import MCPServerStreamableHttp server = MCPServerStreamableHttp( name="fxmacrodata", params={"url": "https://fxmacrodata.com/mcp"}, )

Works without a key for USD data. The SDK can use OAuth-discovered bearer tokens, host-managed client credentials, or a direct API-key URL such as "url": "https://fxmacrodata.com/mcp?api_key=YOUR_KEY".
3

Create an agent and run

import asyncio from agents import Agent, Runner async def main(): async with server: agent = Agent( name="FX Macro Analyst", instructions="Analyse FX markets using macro data from FXMacroData.", mcp_servers=[server], ) result = await Runner.run(agent, "What is the EUR/USD rate differential?") print(result.final_output) asyncio.run(main())
4

Available tools

The agent auto-discovers 30 FXMacroData tools across connectivity, catalogue, calendars, FX spot, indicator tables, visual artifacts, MCP Apps, workflow tasks, COT, commodities, and official dataset families.

OpenAI Agents SDK resources

See the MCP guide and the openai-agents GitHub repo for full documentation.

Continue, Cline, Windsurf, Replit, Zed, Kiro, JetBrains

Use the production MCP endpoint in the client-specific config shape.

Endpoint: https://fxmacrodata.com/mcp. For IDEs without OAuth support, use https://fxmacrodata.com/mcp?api_key=YOUR_KEY.

Continue

1. Create .continue/mcpServers/fxmacrodata.yaml in your workspace.
2. Add FXMacroData as a Streamable HTTP MCP server.
3. Use Continue in Agent mode and ask: "List available USD indicators from FXMacroData."

name: FXMacroData
version: 0.0.1
schema: v1
mcpServers:
  - name: FXMacroData
    type: streamable-http
    url: https://fxmacrodata.com/mcp

Cline and Roo Code

1. Open the MCP Servers panel, then choose Configure MCP Servers or Remote Servers.
2. For remote setup, enter server name FXMacroData, URL https://fxmacrodata.com/mcp, and Streamable HTTP.
3. If editing JSON directly, add the same server under mcpServers.

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Some Cline builds also accept "type": "streamableHttp" for hosted HTTP servers. If the UI offers a transport selector, choose Streamable HTTP.

Windsurf / Cascade

1. Go to Settings -> Tools -> Windsurf Settings -> Add Server, or open the raw config.
2. In ~/.codeium/mcp_config.json, add a remote HTTP server using serverUrl or url.
3. Save, then refresh the MCP plugins list so Cascade fetches the tools.

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp"
    }
  }
}

Replit Agent

1. Open Replit Integrations and find MCP Servers for Replit Agent.
2. Click + Add MCP server.
3. Set display name to FXMacroData and MCP Server URL to https://fxmacrodata.com/mcp.
4. Click Test & save. Replit will connect and start any OAuth flow the server requires.

Zed

1. Open the Agent Panel settings or edit Zed settings directly.
2. Add FXMacroData under context_servers.
3. If no Authorization header is configured, Zed can prompt for the standard MCP OAuth flow.

{
  "context_servers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

Kiro

1. Open the command palette and choose Kiro: Open user MCP config or Kiro: Open workspace MCP config.
2. Add FXMacroData to ~/.kiro/settings/mcp.json or .kiro/settings/mcp.json.
3. Save the file. Kiro reconnects automatically and can run browser-based OAuth for remote servers.

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

JetBrains AI Assistant

1. Go to Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP).
2. Click Add, choose HTTP / Streamable HTTP, and paste the JSON configuration.
3. Click OK and Apply, then confirm FXMacroData appears with an active status.

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

Universal fallback

If your IDE is not listed, look for an MCP, Tools, Plugins, or Agent settings screen. Use Streamable HTTP when available, set the URL to https://fxmacrodata.com/mcp, then verify with the prompt "Run FXMacroData ping and list available USD indicators."

Custom SDK / Agent Runtime

Streamable HTTP transport · any MCP-compatible client

1

Configure streamable HTTP transport

https://fxmacrodata.com/mcp
2

Send MCP initialize, then tools/list

Include Accept: application/json in headers.
3

Choose the auth workflow your host supports

No auth is needed for USD data. For protected data, FXMacroData supports OAuth PKCE public clients, confidential OAuth clients using client_secret_post or client_secret_basic, bearer tokens via Authorization: Bearer <token>, and direct API keys via ?api_key=YOUR_KEY.

OAuth compatibility

Most MCP hosts should discover OAuth automatically from the MCP URL. If a host asks you to enter an OAuth client ID and secret manually, FXMacroData also supports confidential clients. Use the host-specific credentials provided to you, or fall back to ?api_key=YOUR_KEY if your integration only needs direct API-key auth.

Example: Live in Claude

Claude claude.ai

FXMacroData connected

What's the EUR vs USD interest rate differential, and what does it mean for EUR/USD?

indicator_query(currency="eur", indicator="policy_rate")

indicator_query(currency="usd", indicator="policy_rate")

Tool results

ECB (EUR) policy_rate: 4.25%

Fed (USD) policy_rate: 5.50%

Differential: −1.25% (USD premium)

Based on the latest central bank data from FXMacroData, the Fed rate of 5.50% exceeds the ECB rate of 4.25% by 125 basis points. This USD rate premium is a structurally bearish factor for EUR/USD — higher US yields attract capital flows that support dollar strength relative to the euro.

Ask about FX macro data...

Chart Artifacts

FXMacroData MCP Apps span release calendars, indicator visuals, pair-comparison analysis, cross-currency heatmaps, scenario tooling, war-room workflows, event replay, quant distributions, and subscription unlock flows. Each image below is captured from a real local MCP app render; the final in-chat experience depends on whether the host mounts MCP Apps resources inline.

MCP indicator app preview with rendered USD inflation chart — Indicator chart app with premium analysis cards and signal pills.

MCP indicator app with Area, MA(5), and Trend controls enabled — Indicator control stack in action: Area + MA(5) + Trend overlays.

MCP comparison app for multi-series and spread views — Comparison app surface for line, spread, ratio, normalized, and z-score modes.

MCP macro heatmap app for cross-currency matrix analysis — Macro heatmap app with mode toggles and matrix scale legend.

MCP policy scenario modeler app with FX elasticity controls — Policy scenario modeler for spread shocks and projected spot outputs.

MCP macro war room app showing pair context and release controls — Macro war room cockpit for pair context, release queue, and risk alerts.

MCP event impact replay app with timeline controls — Event impact replay timeline for point-in-time market context reviews.

MCP quant scenario lab app with stress percentiles — Quant scenario lab for stress distribution inputs and percentile outputs.

Claude claude.ai

FXMacroData connected

Plot the USD policy rate since 2020 as a chart

indicator_visual_artifact(currency="usd", indicator="policy_rate", start_date="2020-01-01")

USD / POLICY_RATE 15 points · latest 2024-12 = 4.50%

FX Macrodata · indicator_visual_artifact · interactive in Claude

Here is the USD policy rate (Fed funds rate) from 2020 to 2024. The rate was held near zero through 2021, then the Fed launched its fastest hiking cycle in decades — rising from 0.25% to a peak of 5.50% by mid-2023. The first cuts began in late 2024, bringing the rate back to 4.50%.

MCP Apps Explorer

MCP Apps are best when the answer should stay interactive inside the conversation. FXMacroData now exposes release-calendar, charting, pair intelligence, macro heatmap, policy scenario, macro war room, event replay, and quant lab app flows. For persistent hosts like Claude Code and Gemini-driven coding agents, the server also exposes task-capable non-visual research workflows that can be polled and reused across a long thread.

Release calendar app

"Show me the USD GDP release calendar in Sao Paulo time"

release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo") -> ui://fxmacrodata/release-calendar.html

Interactive chart widget

"Show me a chart of AUD policy rate history"

indicator_visual_artifact(currency="aud", indicator="policy_rate")

FX pair comparison app

"Compare EUR and USD policy rates with carry context"

pair_intel_task(base="eur", quote="usd")

Macro heatmap app

"Show me the strongest and weakest macro prints across G10"

macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")

Scenario modeler app

"What happens if the Fed hikes 50 bps more?"

policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)

Macro war room app

"Build me a live EUR/USD macro war room for USD GDP"

macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")

Event replay app

"Replay USD GDP surprises against EUR/USD"

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)

Quant scenario lab app

"Run a 30-day stress distribution for EUR/USD after a base-leg shock"

quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)

Capabilities, Apps, and Tasks

Remote MCP transport

▸ Streamable HTTP endpoint at https://fxmacrodata.com/mcp
▸ Plain JSON responses for proxy/CDN compatibility
▸ Stateless HTTP requests, so every call carries its own auth context

MCP Apps resources

Visual tools return structured data plus ui:// resource metadata so compatible hosts can render chart and workflow apps inline.

ui://fxmacrodata/indicator-chart.html

ui://fxmacrodata/comparison-chart.html

ui://fxmacrodata/release-calendar.html

ui://fxmacrodata/macro-heatmap.html

ui://fxmacrodata/scenario-modeler.html

ui://fxmacrodata/macro-war-room.html

ui://fxmacrodata/event-impact-replay.html

ui://fxmacrodata/quant-scenario-lab.html

ui://fxmacrodata/subscribe-cta.html

Task-capable tools

Advanced workflow tools can be called like normal tools. Hosts that support experimental MCP Tasks can also create a task, poll status with tasks/get, and retrieve the final payload when complete.

macro_briefing_task known_at_time_task fx_backtest_task macro_research_pack_task portfolio_risk_engine_task

Built-in prompts

Prompt-aware clients can discover reusable FX workflows through prompts/list and invoke them with prompts/get. The public prompt library mirrors these routines with copyable prompts, guardrails, and machine-readable feeds.

macro_briefing rate_decision_brief pair_analysis pre_central_bank_decision_brief post_release_trade_summary pair_risk_check week_ahead_macro_plan data_quality_audit release_risk_ladder known_at_time_backtest_check event_gated_backtest_brief portfolio_event_risk_scan cot_positioning_context commodity_fx_context visualize_macro_series

Tool Catalog

30 tools

FXMacroData exposes a read-only tool surface. The detailed cards below cover the core tools most users call directly; the complete public tool set is grouped here for quick discovery.

Core data

ping data_catalogue indicator_query release_calendar forex market_sessions cot_data commodities official_dataset_family

Visual artifacts

indicator_visual_artifact forex_visual_artifact commodities_visual_artifact cot_visual_artifact policy_rate_differential_visual_artifact

App and research workflows

macro_briefing_task indicator_intel_task pair_intel_task macro_heatmap_task policy_scenario_modeler_task macro_war_room_task event_impact_replay_task quant_scenario_lab_task

Decision and portfolio tasks

known_at_time_task macro_regime_classifier_task release_risk_score_task portfolio_risk_engine_task fx_trade_setup_task fx_backtest_task macro_research_pack_task subscribe_for_mcp_access

data_catalogue read-only

currency

Returns all available indicators and metadata for a given currency code. Keep include_coverage=true and use include_capabilities=true when deciding whether a sparse series has recent observations.

Input: currency, include_coverage?, include_capabilities?, indicator? Output: {currency, catalogue[], coverage[], mcp_metadata}

indicator_query read-only

currency · indicator · dates

Returns macroeconomic indicator time series for a currency. Supports policy_rate, inflation, gdp, employment, and more. Pagination mirrors REST: limit, offset, page, and pagination.next_offset. Use mcp_metadata and result.data_quality for freshness and source checks.

Input: currency, indicator, start_date?, end_date?, limit?, offset?, page? Output: {currency, indicator, pagination, data[], data_quality, mcp_metadata}

indicator_visual_artifact visual

currency · indicator · dates

Returns indicator time series with MCP Apps metadata so compatible clients can render an interactive chart artifact in-context. Use the same limit, offset, or page controls for broad chart windows.

Input: currency, indicator, start_date?, end_date?, limit?, offset?, page? Output: structuredContent + chart resource

release_calendar read-only app

currency · indicator?

Returns upcoming release timestamps with optional indicator filtering and requested IANA timezone conversion, plus Release Calendar App metadata for compatible hosts. Inspect mcp_metadata before using event timing in automation.

Input: currency, indicator?, timezone? Output: {currency, timezone, requested_timezone, data[], mcp_metadata} + resource_link Rows: UTC, market-local, requested-timezone ISO fields App: ui://fxmacrodata/release-calendar.html

forex read-only

base · quote · dates · indicators?

Returns FX spot-rate rows with optional technical indicators. Inspect pair_metadata, data_quality.source_legs, and row-level data[].source before classifying a pair as directly available, inverted, cross-derived, peg-based, or lower-frequency expanded.

FX source priority is BIS XRU daily USD rates where available, then official national-bank daily sources, labelled EUR/CAD-derived crosses, official USD pegs, BIS monthly averages expanded to business days, IMF IFS monthly rates, and World Bank annual rates. Monthly and annual expansions remain labelled through source_frequency and derivation_method.

Input: base, quote, start_date?, end_date?, indicators?, limit?, offset?, page? Output: {base, quote, data[], pair_metadata, data_quality, indicators?, mcp_metadata} Check: direct_available, inverse_available, is_derived, derivation_method, source_legs, pair_consistency_check

cot_data read-only

currency · dates

Returns CFTC Commitment of Traders (COT) weekly positioning data for a currency's FX futures contract, including the same compact freshness and provenance metadata used by other raw MCP tools.

Input: currency, start_date?, end_date? Output: {currency, data[], data_quality, mcp_metadata}

commodities read-only

indicator · dates

Returns commodity and energy indicator time series. Covers gold, oil (Brent/WTI), and natural gas. The parameter is indicator, for example indicator="gold".

Input: indicator, start_date?, end_date? Output: {indicator, data[], data_quality, mcp_metadata}

known_at_time_task task

currency · indicator · as_of

Returns the point-in-time-safe slice of a macro series using announcement timestamps as the integrity boundary.

Input: currency, indicator, as_of, start_date?, end_date? Output: {known_rows[], latest_known, integrity}

macro_regime_classifier_task task

currency

Classifies a currency's macro regime from policy, inflation, growth, and labor context with explicit confidence notes.

Input: currency, start_date?, end_date? Output: {regime, latest, signals, confidence_notes}

release_risk_score_task task

base · quote

Ranks the next release slate for a pair using pair-aware heuristic impact weights.

Input: base, quote, horizon_events? Output: {events[], top_risk, methodology}

portfolio_risk_engine_task task

portfolio

Evaluates an FX portfolio with stress PnL, concentration diagnostics, currency exposure, and event-at-risk ranking from release calendars.

Input: positions_json, stress_shock_pct?, horizon_events? Output: {portfolio, positions, exposure_by_currency, event_risk, risk_flags}

fx_trade_setup_task task

base · quote

Builds a trader-facing FX pair setup with directional bias, macro differentials, catalyst ranking, execution window context, and invalidation notes.

Input: base, quote, horizon_events?, include_cot? Output: {bias, spot_context, catalysts, execution, quality}

fx_backtest_task task

base · quote · dates

Runs a transparent rule-based FX backtest with carry/momentum signals, benchmark comparison, equity curve output, and optional release-window event gating.

Input: base, quote, start_date?, end_date?, strategy?, momentum_lookback?, transaction_cost_bps?, initial_capital?, event_gated?, event_window_days? Output: {metrics, benchmark, assumptions, series.equity_curve}

macro_research_pack_task task

currency · indicator

Builds a reusable research payload that combines catalogue validation, series history, next release timing, and optional FX context.

Input: currency, indicator, base?, quote?, start_date?, end_date? Output: {catalogue, series, next_release, fx_context}

Research Playbooks

The best MCP workflows combine discovery, exact data retrieval, and a final synthesis step. These playbooks are the patterns we recommend for analysts, traders, and agent builders who want reliable macro answers instead of one-off tool calls.

Central-bank decision day

Use this before a Fed, ECB, BoE, BoJ, RBA, BoC, SNB, or RBNZ decision. The assistant should check the latest policy rate, inflation path, labor market, next scheduled release, and regime classification before writing the brief.

macro_regime_classifier_task(currency="usd") -> indicator_query(policy_rate) -> release_calendar(policy_rate)

Post-release FX reaction

Use this after CPI, GDP, payrolls, unemployment, or retail sales prints. The agent should compare the latest row to prior context, replay recent event history, and map implications to the relevant FX pair.

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd")

Pre-trade macro checklist

Use this before expressing a view in a currency pair. The assistant should inspect spot context, carry, inflation divergence, upcoming releases, current sessions, and COT positioning where available.

fx_trade_setup_task(base="eur", quote="usd", horizon_events=4)

Portfolio event-risk scan

Use this when you have several FX positions and need to know which upcoming events matter most. The task maps exposures by currency, estimates stress PnL, and ranks event risks.

portfolio_risk_engine_task(positions_json='[{"base":"eur","quote":"usd","side":"long","notional":100000}]')

Point-in-time backtest hygiene

Use this when a strategy depends on macro releases. The assistant should avoid lookahead by filtering rows through announcement timestamps and, when relevant, event-gating the backtest window.

known_at_time_task(currency="usd", indicator="gdp", as_of="2025-01-15")

Agent-built macro apps

Use this when a coding agent is building dashboards, notebooks, alerts, or widgets. Start with catalogue discovery, ask for exact endpoint shapes, then generate code against production URLs and query-parameter auth examples.

data_catalogue(currency="aud") -> indicator_query(currency="aud", indicator="policy_rate")

Usage Examples

Connectivity check

"Run the FXMacroData ping tool"

ping()

USD inflation time series

"Get USD inflation data from 2024-01-01 to 2025-01-01"

indicator_query(currency="usd", indicator="inflation", start_date="2024-01-01", end_date="2025-01-01")

AUD catalogue discovery

"What AUD indicators are available, and which ones have recent coverage?"

data_catalogue(currency="aud", include_coverage=true, include_capabilities=true)

Freshness and source check

"Get EUR GDP and tell me whether the result is fresh, official, fallback, proxy, or derived."

indicator_query(currency="eur", indicator="gdp") -> inspect mcp_metadata and result.data_quality

USD release calendar

"Show upcoming USD GDP release dates in Brazil time"

release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo")

EUR/USD spot rates

"Show EUR/USD spot rates with RSI and SMA, and tell me whether the pair was direct, inverted, or derived."

forex(base="eur", quote="usd", start_date="2024-01-01", end_date="2024-12-31", indicators="sma_20,rsi_14") -> inspect pair_metadata and data_quality.source_legs

Chart artifact — EUR policy rate

"Plot the EUR policy rate as a chart"

indicator_visual_artifact(currency="eur", indicator="policy_rate")

Live FX sessions

"What FX sessions are open right now?"

market_sessions()

GBP COT positioning

"Show GBP futures positioning data"

cot_data(currency="gbp", start_date="2024-01-01")

Gold price series

"Get gold prices for 2024"

commodities(indicator="gold", start_date="2024-01-01", end_date="2024-12-31")

Cross-market heatmap

"Show me macro winners and losers across USD, EUR, GBP, and JPY"

macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")

Policy scenario modeler

"What if the Fed hikes 50 bps more?"

policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)

Macro war room intelligence

"Assemble a macro war room for EUR/USD and USD GDP"

macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")

Point-in-time event replay

"Replay recent USD GDP events with EUR/USD context"

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)

Quant scenario stress lab

"Run an advanced EUR/USD scenario with volatility bands"

quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)

Point-in-time macro slice

"Show only what was known about USD GDP by January 15, 2025"

known_at_time_task(currency="usd", indicator="gdp", as_of="2025-01-15T00:00:00Z")

Macro regime classifier

"Classify the current USD macro regime"

macro_regime_classifier_task(currency="usd")

Pair release risk scoring

"What are the biggest scheduled risks for EUR/USD next?"

release_risk_score_task(base="eur", quote="usd", horizon_events=6)

Portfolio risk engine

"Score risk and event exposure for my EUR/USD and GBP/USD book"

portfolio_risk_engine_task(positions_json='[{"base":"eur","quote":"usd","side":"long","notional":100000},{"base":"gbp","quote":"usd","side":"short","notional":80000}]', stress_shock_pct=1.5, horizon_events=5)

Trader-ready FX setup

"Build me a trade setup for EUR/USD with catalysts and invalidation notes"

fx_trade_setup_task(base="eur", quote="usd", horizon_events=4)

Event-gated strategy backtest

"Backtest EUR/USD carry + momentum around macro release windows with realistic trading costs"

fx_backtest_task(base="eur", quote="usd", start_date="2024-01-01", end_date="2025-01-01", strategy="carry_momentum", momentum_lookback=10, transaction_cost_bps=2.0, event_gated=true, event_window_days=1)

Persistent research pack

"Build one canonical research payload for USD GDP with EUR/USD context"

macro_research_pack_task(currency="usd", indicator="gdp", base="eur", quote="usd")

Authentication

No auth Public (USD)

▸ Connect with just the bare URL
▸ USD indicators (last 365 days), FX rates, catalogue, calendar, sessions
▸ No API key or OAuth required

Full access OAuth 2.0 + PKCE

▸ Authorization code flow with PKCE
▸ Scope: fxmacrodata.read
▸ Bearer transport: Authorization: Bearer <token>
▸ Dynamic Client Registration for clients that self-register

Full access API Key

▸ Append to MCP URL as query param
▸ /mcp?api_key=YOUR_KEY
▸ Best for IDE / SDK runtimes without OAuth

Access tiers: USD indicators (most recent 365 days), FX rates, catalogue, calendar, and sessions are free — no key needed. Non-USD indicators, the full USD historical archive, COT, and commodities require an API key. Get access →

OAuth endpoints

Authorization:https://fxmacrodata.com/api/oauth/authorize

Token:https://fxmacrodata.com/api/oauth/token

Registration:https://fxmacrodata.com/api/oauth/register

Metadata:https://fxmacrodata.com/.well-known/oauth-authorization-server

Protected resource:https://fxmacrodata.com/api/.well-known/oauth-protected-resource

OAuth client support

▸ Public PKCE clients with token_endpoint_auth_method=none
▸ Confidential clients using client_secret_post or client_secret_basic
▸ Bearer tokens resolved back to the API-key subscription context for protected tools

Redirect URI support

Most supported MCP hosts discover the correct OAuth settings from the metadata URL above. For custom clients, register the redirect URI required by your MCP host and keep client credentials out of shared config files.

Server Details

MCP base URL

https://fxmacrodata.com/mcp

Transport

Streamable HTTP

Security

HTTPS / TLS

Status

General Availability

Availability

Production HTTPS endpoint

REST routes

22 public endpoints

Quick Validation

bash

# API health check
curl -i https://fxmacrodata.com/api/v1/ping

# OAuth metadata
curl -i https://fxmacrodata.com/.well-known/oauth-authorization-server

# OAuth metadata (API alias)
curl -i https://fxmacrodata.com/api/.well-known/oauth-authorization-server

# MCP route probe (JSON guidance expected for plain GET)
curl -i https://fxmacrodata.com/mcp

# MCP initialize
curl -i -X POST "https://fxmacrodata.com/mcp" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    --data '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# MCP tools/list
curl -i -X POST "https://fxmacrodata.com/mcp" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    --data '{"jsonrpc":"2.0","id":"2","method":"tools/list","params":{}}'

# Authenticated indicator_query
curl -i -X POST "https://fxmacrodata.com/mcp" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    --data '{"jsonrpc":"2.0","id":"3","method":"tools/call","params":{"name":"indicator_query","arguments":{"currency":"usd","indicator":"inflation","start_date":"2024-01-01","end_date":"2025-01-01"}}}'

Error Reference

Status	Meaning
406	Unsupported Accept header or wrong HTTP method (for example, non-JSON protocol calls)
400	Invalid MCP request format
401/403	Authentication or authorization failure on protected data
200	Valid MCP initialize with `Accept: application/json` returns server capabilities and instructions

Support & Privacy

[email protected] Privacy Policy Terms of Service

Summarize article with AI:

ChatGPT Perplexity Claude Grok Gemini Mistral

AI Answer-Ready

Key Facts

Page: MCP Server
Section: Documentation
Canonical URL: https://fxmacrodata.com/vi/documentation/mcp-server
Source: FXMacroData editorial and official publisher references
Last Updated: See page metadata

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

Quick Q&A

What is this page about? This page explains MCP Server with directly usable context for trading, research, and API workflows.

What source should be cited? Use the canonical URL and the listed source field; cite official publisher references when available.

How fresh is this content? The last updated value above reflects the page metadata or latest available data timestamp.

Can this be used in AI assistants? Yes. This section is intentionally structured for retrieval and citation in chat assistants.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.