Trading 212 MCP Server

An MCP (Model Context Protocol) server that wraps the Trading 212 Public API v0, enabling AI agents to interact with your Trading 212 brokerage account through natural language.

Features

16 tools across 5 categories:

Category	Tools	Description
Accounts	get_account_summary	Cash breakdown, investment metrics, total value
Instruments	get_instruments, get_exchanges	Tradable instruments and exchange schedules
Positions	get_open_positions	All open positions with P&L and wallet impact
Orders	get_pending_orders, get_order_by_id, place_market_order, place_limit_order, place_stop_order, place_stop_limit_order, cancel_order	Full order lifecycle management
History	get_historical_orders, get_dividends, get_transactions, request_csv_report, get_reports	Historical data with pagination and CSV export

Prerequisites

1. A Trading 212 Invest or Stocks ISA account
2. API key + secret generated from the Trading 212 app (Settings → API)
3. Node.js ≥ 18

Setup

# Clone and install
cd trading212-mcp
npm install

# Build
npm run build

Configuration

Set these environment variables before running:

Variable	Required	Description
T212_API_KEY	✅	Your Trading 212 API key
T212_API_SECRET	✅	Your Trading 212 API secret
T212_ENV	❌	demo (default) or live

Usage with Claude Desktop / Gemini CLI

Add to your MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "trading212": {
      "command": "node",
      "args": ["c:/GenAI/trading212-mcp/dist/index.js"],
      "env": {
        "T212_API_KEY": "your_api_key",
        "T212_API_SECRET": "your_api_secret",
        "T212_ENV": "demo"
      }
    }
  }
}

Usage with VS Code / Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "trading212": {
      "command": "node",
      "args": ["c:/GenAI/trading212-mcp/dist/index.js"],
      "env": {
        "T212_API_KEY": "your_api_key",
        "T212_API_SECRET": "your_api_secret",
        "T212_ENV": "demo"
      }
    }
  }
}

Development

# Run in development mode (no build step)
npm run dev

⚠️ Important Notes

• Default environment is demo (paper trading) — no real money at risk
• Order tools are NOT idempotent — duplicate calls create duplicate orders
• Sell convention: use a negative quantity (e.g. -10.5 sells 10.5 shares)
• All rate limits are enforced per-account by Trading 212's servers
• API is currently in beta — see Trading 212 API docs

License

MIT