FXMacroData MCP Server

Open Command Palette → MCP: Add Server

Or edit .vscode/mcp.json directly.

Add this configuration

For VS Code in this repository, use servers (not mcpServers).

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

Start using it

Works immediately for USD data. VS Code can use OAuth with PKCE and no client secret, bearer tokens, or a direct API-key fallback. For all 18 currencies, either complete the OAuth prompt or append ?api_key=YOUR_KEY to the URL.

Open Cursor Settings → MCP

Click Add new global MCP server.

Add to ~/.cursor/mcp.json

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

Cursor uses mcpServers; VS Code workspace configs in this repo use servers. Cursor can use OAuth discovery when the host supports it. As a direct fallback, append ?api_key=YOUR_KEY to the URL.

Reload and verify

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

Enable developer mode

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

Create a connector

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

Works without a key for USD data and public tools. 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.

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

View the interactive chart widget

Ask for "Show me a chart of AUD policy rate history" — ChatGPT will render an interactive time-series chart inline using the MCP Apps widget.

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

Authenticate for full coverage

USD public tools work immediately. For non-USD series, use an authenticated connector URL such as https://fxmacrodata.com/mcp?api_key=YOUR_KEY.

Run quick checks

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

Install the Agents SDK

Register the FXMacroData MCP server

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

Create an agent and run

Available tools

The agent auto-discovers all FXMacroData tools: ping, data_catalogue, indicator_query, indicator_visual_artifact, release_calendar, forex, market_sessions, cot_data, commodities.

Configure streamable HTTP transport

Send MCP initialize, then tools/list

Include Accept: application/json in headers.

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.