T212 Server

npm version License: MIT

A Model Context Protocol (MCP) server for interacting with the Trading 212 API. Gives AI assistants read-only access to your Trading 212 account — positions, account summary, instruments, order history, dividends, and more.

Features

• 📊 Portfolio positions with P/L and wallet impact
• 💰 Account summary (cash, investments, realized/unrealized P/L)
• 🔍 Instrument search (16,000+ stocks, ETFs, and more)
• 🏛️ Exchange schedules and working hours
• 📜 Order history, dividend history, and transaction history
• 📁 CSV export reports
• 🔒 Read-only — no trading operations
• 🧪 Demo mode for paper trading
• 🤖 Compatible with Claude, and other MCP clients

Quick Start

Prerequisites

• Node.js v18 or higher
• A Trading 212 API key and secret (get yours here)
• Claude Desktop or another MCP-compatible client

Configuration for Claude Desktop

Add this to your Claude Desktop configuration file:

Option 1: No installation required (recommended)

{
  "mcpServers": {
    "t212-mcp": {
      "command": "npx",
      "args": ["t212-mcp-server"],
      "env": {
        "T212_API_KEY": "your-api-key-id",
        "T212_API_SECRET": "your-api-secret"
      }
    }
  }
}

Option 2: Global installation

npm install -g t212-mcp-server

{
  "mcpServers": {
    "t212-mcp": {
      "command": "t212-mcp-server",
      "env": {
        "T212_API_KEY": "your-api-key-id",
        "T212_API_SECRET": "your-api-secret"
      }
    }
  }
}

Demo Mode

To use paper trading instead of your live account, add T212_ENVIRONMENT:

{
  "env": {
    "T212_API_KEY": "your-demo-api-key-id",
    "T212_API_SECRET": "your-demo-api-secret",
    "T212_ENVIRONMENT": "demo"
  }
}

How to access the Claude Desktop config file

1. Open Claude Desktop Settings
2. Go to the Developer tab
3. Click "Edit Config"
4. Add your configuration and save
5. Restart Claude Desktop

For detailed configuration instructions, see the official MCP documentation.

Getting your Trading 212 API Credentials

1. Log into your Trading 212 account
2. Navigate to Settings → API
3. Generate a new API key
4. Copy both the API Key ID and the Secret Key (the secret is only shown at creation time)
5. Use both values in your configuration as T212_API_KEY and T212_API_SECRET

For more details, see the Trading 212 Help Centre.

Available Tools

Tool	Description
fetch-open-positions	All open positions with current price, P/L, and wallet impact
fetch-position	A specific position by ticker
fetch-account-summary	Account cash balance, investment value, and P/L
search-instruments	Search 16,000+ instruments by name, ticker, or ISIN
fetch-exchanges	All exchanges with next open/close times
fetch-order-history	Historical filled orders (paginated)
fetch-dividend-history	Dividend payments (paginated)
fetch-transaction-history	Deposits and withdrawals (paginated)
fetch-exports	CSV export reports with download links
fetch-all-pies	Investment pies (deprecated by Trading 212)

Environment Variables

Variable	Required	Description
T212_API_KEY	Yes	Your Trading 212 API Key ID
T212_API_SECRET	Yes	Your Trading 212 API Secret
T212_ENVIRONMENT	No	live (default) or demo for paper trading

Security Notes

• ⚠️ Never commit your API credentials to version control
• 🔒 Keep your MCP configuration file secure
• 🔄 Regularly rotate your API keys
• 📝 This server provides read-only access only

License

This project is licensed under the MIT License — see the LICENSE file for details.

Support

If you encounter any issues or have questions:

1. Check the issues page
2. Create a new issue if your problem isn't already reported
3. Provide as much detail as possible, including error messages and your configuration