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

| Tool | Description | |------|-------------| | get_auth_status | Check API key status, login, margin mode, permissions | | get_account | Balance, equity, margin, P&L, leverage | | get_positions | All open positions with P&L | | get_orders | Pending limit/stop orders | | get_history | Deal history by period or date range | | get_symbols | All 400+ tradeable instruments | | get_symbol | Detailed spec for one symbol (digits, volume limits, spread, swaps, margins, sessions) | | get_quote | Live bid/ask prices for one or more symbols (max 20) |

Trading

| Tool | Description | |------|-------------| | trade | Open a position (buy/sell) with optional SL/TP | | close_position | Close a position (full or partial) | | modify_position | Change SL/TP on an existing position | | close_by | Close against an opposite position (hedging mode) | | reverse_position | Reverse a position direction | | close_all | Close all open positions | | close_symbol | Close all positions for one symbol |

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