FXMacroData MCP Server

Real-time forex macroeconomic API for all major currency pairs sourced from central bank announcements.

View on fxmacrodata.com

Documentation

AI Answer-Ready

Key Facts

Page

MCP Server

Section

Documentation

Canonical URL

https://fxmacrodata.com/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

Copy Trader Prompt Copy Quant Prompt Copy News Prompt

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

Live MCP · Streamable HTTP OAuth 2.0 + PKCE

FXMacroDataMCP Server

Connect Claude, Cursor, VS Code, or any MCP-compatible AI host to live central bank and macroeconomic data. Ask questions in plain English — no code required.

https://fxmacrodata.com/mcp

9 tools available

9 REST routes

First API call

Quick Request

Use any language snippet below. Authentication uses the api_key query parameter.

curl Python JavaScript

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

Copy

Quick Connect

Claude VS Code ◈ Cursor ChatGPT Mistral OpenAI SDK / Agent

Claude (Web & Desktop)

claude.ai — remote MCP connector

  1. 1
    Open Claude → Settings → Connectors
    Click Add MCP Server and select Remote.
  2. 2
    Enter the server URL
    https://fxmacrodata.com/mcp
  3. 3
    Start using it
    USD data and public tools work immediately with no key. For full access, 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. 4
    Verify the connection
    In a new chat, ask: "Run the FXMacroData ping tool", "Show me available USD indicators", or "What sessions are open right now?"

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

Use indicator_visual_artifact to render an interactive chart widget directly inside AI clients that support MCP Apps.

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%.

Tool Catalog

6 tools

data_catalogue read-only

currency

Returns all available indicators and metadata for a given currency code.

Input: currency (e.g. "usd") Output: {currency, catalogue[]}

indicator_query read-only

currency · indicator · dates

Returns macroeconomic indicator time series for a currency. Supports policy_rate, inflation, gdp, employment, and more.

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

indicator_visual_artifact visual

Returns indicator time series with MCP Apps metadata so compatible clients can render an interactive chart artifact in-context.

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

release_calendar read-only

currency · indicator?

Returns upcoming release timestamps with optional indicator filtering.

Input: currency, indicator? Output: {currency, indicator, data[]}

cot_data read-only

currency · dates

Returns CFTC Commitment of Traders (COT) weekly positioning data for a currency's FX futures contract.

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

commodities read-only

indicator · dates

Returns commodity and energy indicator time series. Covers gold, oil (Brent/WTI), and natural gas.

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

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?"

data_catalogue(currency="aud")

USD release calendar

"Show upcoming USD GDP release dates"

release_calendar(currency="usd", indicator="gdp")

EUR/USD spot rates

"Show EUR/USD spot rates with RSI and SMA"

forex(base="eur", quote="usd", start_date="2024-01-01", end_date="2024-12-31", indicators="sma_20,rsi_14")

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")

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>

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

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

Allowed OAuth callbacks

http://localhost:6274/oauth/callback

http://localhost:6274/oauth/callback/debug

https://claude.ai/api/mcp/auth\_callback

https://claude.com/api/mcp/auth\_callback

Server Details

MCP base URL

https://fxmacrodata.com/mcp

Transport

Streamable HTTP

Security

HTTPS / TLS

Status

General Availability

Deployment

Google Cloud Run

REST routes

9 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

StatusMeaning
406Unsupported Accept header or wrong HTTP method (for example, non-JSON protocol calls)
400Invalid MCP request format
401/403Authentication or authorization failure on protected data
200Valid 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