t212-mcp

A Model Context Protocol server that gives an AI assistant read-only access to a Trading 212 investing account: balances, positions, order and dividend history, pies, and the instrument catalogue.

It cannot trade. No tool places, amends or cancels an order, or changes a pie. The HTTP client has no code path that issues anything but a GET. See Security.

You: How is my portfolio doing, and which holding is furthest from its pie target?

  → t212_get_account_info    reporting currency
  → t212_get_account_cash    balance and unrealised P/L
  → t212_list_positions      holdings, ranked by value
  → t212_list_pies           pie valuations
  → t212_get_pie             allocation drift

Requirements

• Node.js 20.11 or newer

• A Trading 212 API key — in the app: Settings → API

Trading 212 issues separate credentials for practice and real-money accounts, and a key from one is rejected by the other. Start with the practice account.

Related MCP server: robinhood-mcp

Quick start

npx t212-mcp

It speaks MCP over stdio, so run it from a client rather than directly.

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "trading212": {
      "command": "npx",
      "args": ["-y", "t212-mcp"],
      "env": {
        "T212_API_KEY": "your-key",
        "T212_ENVIRONMENT": "demo"
      }
    }
  }
}

Claude Code

claude mcp add trading212 \
  --env T212_API_KEY=your-key \
  --env T212_ENVIRONMENT=demo \
  -- npx -y t212-mcp

Any MCP client

Run npx -y t212-mcp with the environment below and connect over stdio.

Configuration

The environment defaults to demo deliberately: the failure mode of that default is reading play money by accident, which is the only acceptable direction for the mistake to go.

See .env.example.

Tools

Also exposed: a t212://connection resource describing the connection (no credentials, no network call), and a portfolio_review prompt.

Every tool is annotated readOnlyHint: true and destructiveHint: false.

Ticker format

Trading 212 tickers carry a market suffix: AAPL_US_EQ, not AAPL. Ask the assistant for a company by name — t212_search_instruments resolves it.

Rate limits and caching

Trading 212's limits are strict and per-endpoint; the instrument catalogue allows roughly one call per minute. The server shapes requests with a token bucket per endpoint group and waits for budget rather than being rejected and retrying blind.

Cache lifetimes are assigned by what the data is, not uniformly:

Stale reference data is cosmetic; a stale balance quoted as current is a wrong answer. Concurrent identical requests share one call.

Security

Read SECURITY.md for the full threat model. In short:

• Read-only by construction. The HTTP client exposes only get and has no path that can issue another method. Order placement, cancellation and pie mutation exist in the Trading 212 API and are deliberately absent here, so a prompt injection reaching a tool call cannot move money.

• Credentials stay in the process. Read from the environment, sent only to the configured Trading 212 host over TLS, never written to disk, never in a tool result, and scrubbed from logs and error messages by key name and by literal value.

• Your data goes to your model provider. Anything a tool returns — balances, positions, transaction history — is sent to whichever model your client talks to. That is how MCP works, but decide knowingly before pointing this at a live account.

• CSV exports are opt-in. Export download links grant access to a full account statement without further authentication, so the tools are hidden entirely unless T212_ALLOW_EXPORTS is set.

Create your API key with the narrowest scopes you need. This server never uses order-placement scopes.

Development

npm ci
npm run check   # format, lint, typecheck, test — what CI runs
npm run dev     # run from source with reload

See CONTRIBUTING.md.

Docker

docker build -t t212-mcp .
docker run --rm -i -e T212_API_KEY=your-key t212-mcp

-i is required: the server talks over stdin and stdout.

Disclaimer

Not affiliated with or endorsed by Trading 212. The Trading 212 API is in beta and may change. This software is provided as-is under the MIT licence; nothing it returns is financial advice, and you are responsible for verifying any figure before acting on it.

Licence

MIT