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.

Quick start

No install needed — run with uvx:

uvx mcp-server-fxmacrodata

USD macroeconomic data works immediately with no API key, covering the most recent 90 days. A key unlocks full history, all 18 currencies, and the FX rate, COT and commodities tools:

FXMACRODATA_API_KEY=your_key uvx mcp-server-fxmacrodata

Get a free API key at fxmacrodata.com/api-management.

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 — no local install needed. 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.