XBTFX MCP Trading Server

MCP server for the XBTFX Trading API — trade forex, crypto, metals, indices, stocks, and energies through XBTFX MetaTrader 5 accounts, from any AI agent that supports the Model Context Protocol.

Works with Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf, and any other MCP-compatible client.

Note: This API is for XBTFX trading accounts only. Create an account at my.xbtfx.com and manage API keys at console.xbtfx.com.

Setup

1. Get an API key from console.xbtfx.com

2. Add to your AI tool:

Claude Code

claude mcp add xbtfx-trading -e XBTFX_API_KEY=xbtfx_live_your_key_here -- npx @xbtfx/mcp-trading

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "xbtfx-trading": {
      "command": "npx",
      "args": ["@xbtfx/mcp-trading"],
      "env": {
        "XBTFX_API_KEY": "xbtfx_live_your_key_here"
      }
    }
  }
}

OpenAI Codex

codex mcp add xbtfx-trading -- npx @xbtfx/mcp-trading

Then set the API key in your environment before running Codex:

export XBTFX_API_KEY="xbtfx_live_your_key_here"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "xbtfx-trading": {
      "command": "npx",
      "args": ["@xbtfx/mcp-trading"],
      "env": {
        "XBTFX_API_KEY": "xbtfx_live_your_key_here"
      }
    }
  }
}

Tools

Account & Market Data

Trading

Example Conversation

You: What's my account balance?

AI: calls get_account — Your balance is $988.00 with $888.00 free margin. Leverage is 1:1000. No open positions.

You: Buy 0.01 lots of EURUSD with a 50 pip stop loss

AI: calls get_symbol for EURUSD, then calls trade — Opened BUY 0.01 EURUSD at 1.15350. Set SL at 1.14850 (50 pips). Ticket #23015470.

You: How's that position doing?

AI: calls get_positions — EURUSD BUY 0.01 lots: opened at 1.15350, current price 1.15380, P&L: +$0.30.

API Documentation

• XBTFX Console — API key management

• XBTFX Skills Hub — Detailed API reference

• API Examples — Python, JavaScript, Go, curl

License

MIT