mcp-server-fxmacrodata

A Model Context Protocol (MCP) server for the FXMacroData API: macroeconomic indicators, release calendars, COT positioning, commodities, and FX rates for AI agents.

Covers 22 currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.

Quick start

No install needed. Run with uvx:

uvx mcp-server-fxmacrodata

Evaluate the MCP server without an API key: USD announcements for the most recent 90 days (each release readable 15 minutes after publication), the USD release calendar, USD COT positioning, the data catalogue for every currency, and market sessions. Connect an FXMacroData subscription for every currency, real-time releases, full available history, FX rates and commodities:

FXMACRODATA_API_KEY=your_key uvx mcp-server-fxmacrodata

Subscribe to FXMacroData, then connect the server using your own account's API key.

For a provider-agnostic install guide that works across multiple AI clients, see llms-install.md.

Configure your MCP client

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "your_key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "your_key"
      }
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "your_key"
      }
    }
  }
}

OpenClaw

Add to ~/.openclaw/openclaw.json:

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "your_key"
      }
    }
  }
}

Tip: If your MCP client supports remote HTTP servers, you can connect directly to https://fxmacrodata.com/mcp instead, with no local install. Append ?api_key=your_key for non-USD data.

Available tools

Environment variables

Install with pip

pip install mcp-server-fxmacrodata

Then run:

mcp-server-fxmacrodata

Development

git clone https://github.com/fxmacrodata/mcp-server-fxmacrodata
cd mcp-server-fxmacrodata
pip install -e ".[dev]"
pytest

Debugging

Use the MCP Inspector:

npx @modelcontextprotocol/inspector uvx mcp-server-fxmacrodata

License

MIT. See LICENSE.