FXMacroData MCP¶

MCP server providing AI agents with real-time macroeconomic and foreign exchange intelligence - central bank announcements, Commitment of Traders (COT) data, economic calendars, commodity prices, and forex rates across 18 currencies.

What It Does¶

FX Rates: Real-time and historical exchange rates for 18 major currencies
Central Bank Calendar: Upcoming policy meetings, interest rate decisions, and minutes
COT Data: Weekly Commitment of Traders reports - positioning data from futures markets
Economic Calendar: GDP, CPI, employment, PMI, and other macro releases with forecasts
Commodities: Gold, oil, copper, and agricultural commodity prices
Cross-Rate Analysis: Calculate implied rates and arbitrage opportunities

Why It Matters for Operators¶

Before FXMacroData MCP, an operator managing international payments, import/export pricing, or currency exposure would need: 1. A Bloomberg Terminal ($2,000+/month) or 2. Multiple separate data sources (TradingView for rates, ForexFactory for calendar, CFTC for COT, investing.com for commodities)

Now: AI agent queries everything conversationally:

Agent: "What's the EUR/USD outlook given the ECB meeting next week and current COT positioning?"
→ FXMacroData returns rate + ECB calendar + COT data → AI synthesizes answer

For operators running e-commerce, SaaS with international pricing, or any business with FX exposure, this turns your AI agent into a treasury analyst.

Setup¶

Prerequisites¶

FXMacroData account (fxmacrodata.com)
API key (free tier available)
Python ≥ 3.10

Install¶

pip install fxmacrodata-mcp

Claude Desktop¶

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "python",
      "args": ["-m", "fxmacrodata_mcp"],
      "env": {
        "FXMACRODATA_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / VS Code¶

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "python",
      "args": ["-m", "fxmacrodata_mcp"],
      "env": {
        "FXMACRODATA_API_KEY": "${FXMACRODATA_API_KEY}"
      }
    }
  }
}

Hermes Agent¶

mcp_servers:
  fxmacrodata:
    command: python
    args: ["-m", "fxmacrodata_mcp"]
    env:
      FXMACRODATA_API_KEY: "${FXMACRODATA_API_KEY}"

Tools¶

Tool	Description
`get_fx_rate`	Get current or historical exchange rate for any currency pair
`get_central_bank_calendar`	Upcoming central bank meetings with expected rate decisions
`get_cot_report`	Weekly COT data - speculative vs commercial positioning
`get_economic_calendar`	Economic releases with actual, forecast, and previous values
`get_commodity_price`	Real-time commodity prices (gold, oil, copper, wheat, etc.)
`get_currency_profile`	Overview of a currency's fundamentals, central bank, and key drivers
`calculate_cross_rate`	Calculate implied cross rates and identify arbitrage
`get_interest_rates`	Current benchmark rates for all 18 currencies
`get_inflation_data`	CPI and PPI data with YoY/MoM changes

Currencies Covered¶

USD, EUR, GBP, JPY, CHF, AUD, CAD, NZD, SEK, NOK, DKK, SGD, HKD, KRW, MXN, BRL, ZAR, TRY

Pricing¶

Tier	Price	Includes
Free	$0/month	100 API calls/day, current rates only, basic calendar
Pro	$29/month	10,000 calls/month, historical data (5 years), COT reports
Business	$99/month	50,000 calls/month, full historical (20 years), real-time streaming
Enterprise	Custom	Unlimited, dedicated endpoint, SLA

Use Cases¶

International Pricing Strategy¶

Agent: "EUR/USD dropped 2% this month. How does that affect our European pricing if we want to maintain USD margins?"
→ get_fx_rate(EUR/USD, 30d history) → calculate margin impact → recommend price adjustment

Treasury & Cash Management¶

Agent: "We hold GBP and EUR balances. Given next week's Bank of England and ECB meetings, should we convert to USD now or wait?"
→ get_central_bank_calendar(BoE, ECB) → get_cot_report(GBP, EUR) → analyze positioning → recommend

Import/Export Cost Forecasting¶

Agent: "Our copper component costs are tied to LME prices. What's the 6-month outlook based on COT data and China PMI?"
→ get_commodity_price(copper) → get_cot_report(copper) → get_economic_calendar(China PMI) → forecast

SaaS Multi-Currency Billing¶

Agent: "We bill in 8 currencies. Which ones have moved >1% this week and should we adjust pricing?"
→ get_fx_rate(all_pairs) → calculate_weekly_change → flag pairs >1% → recommend adjustments

Travel & Expense Management¶

Agent: "Our team is traveling to Tokyo next month. Lock in JPY now or wait?"
→ get_fx_rate(USD/JPY) → get_central_bank_calendar(BoJ) → get_cot_report(JPY) → analyze trend → recommend

Data Sources¶

FXMacroData aggregates from official sources: - FX Rates: European Central Bank (ECB) reference rates + market feeds - COT Data: Commodity Futures Trading Commission (CFTC) - weekly, released Fridays - Economic Calendar: National statistics offices + consensus forecasts - Central Bank Calendar: Official announcements from each central bank - Commodities: LME, CME, ICE exchange data

All data is timestamped and source-cited in API responses.

Integration with CorpusIQ¶

CorpusIQ is the connector layer that lets AI assistants read the systems a business already runs on - accounting, payments, CRM, email, files and analytics - and answer with the source named. It is read-only by design: it retrieves data and never writes to, or acts in, a connected system, which is what makes it safe to point at live accounts.

This page is part of the CorpusIQ directory, the reference we maintain for the MCP server and agent-skill ecosystem. Run alongside CorpusIQ, a third-party server like this one can be combined with a company's own business data in a single answer.

See what CorpusIQ connects

Limitations¶

Not real-time tick data: FX rates have ~1-5 minute delay on Free/Pro tiers. Business tier offers real-time streaming.
COT data is weekly: CFTC releases COT every Friday for the preceding Tuesday. Not suitable for intraday positioning analysis.
18 currencies: Covers all major and most EM currencies but not every currency pair. Exotic pairs require Enterprise.
No trade execution: This is a data server only. For trading, pair with Capital.com MCP or similar execution platforms.