Configuration

Environment Variables

Variable	Required	Description
XBTFX_API_KEY	Yes	Your API key from console.xbtfx.com

The API key binds to a single MT5 login. The MCP server uses the same authentication as the REST API.

Installation Methods

npx (recommended)

No install needed — runs the latest version directly:

npx @xbtfx/mcp-trading

Global install

npm install -g @xbtfx/mcp-trading
xbtfx-mcp

From source

git clone https://github.com/XBTFX/xbtfx-mcp-server.git
cd xbtfx-mcp-server
npm install && npm run build
XBTFX_API_KEY=your_key node dist/index.js

Client Configuration

Each AI client has its own way of registering MCP servers:

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

Cursor

Add to .cursor/mcp.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

Set the API key in your environment before running:

export XBTFX_API_KEY="xbtfx_live_your_key_here"

API Endpoint

The MCP server connects to:

https://interface.xbtfx.com

This is hardcoded and cannot be changed. All requests go through Cloudflare and use the same rate limits as direct REST API access (600 weight per minute per API key).

Requirements

• Node.js 18 or later
• A valid XBTFX API key with trade,read permissions