XBTFX 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