kyurish/trading212-mcp-server

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

10 stars 4 forks 品質 80 トレンド 16MIT

MCP server for Trading 212 - portfolio analytics, order management, pies, dividends. Works with Claude, ChatGPT, Cursor, Windsurf.

概要

Connect your AI assistant to your Trading 212 brokerage account. Ask questions about your portfolio, place trades, manage pies, and analyze dividends - all through natural language. Works with , and any client that supports the Model Context Protocol (MCP). - covering the full Trading 212 API, plus 4 analytics tools that combine multiple API calls into actionable insights - - reads T212's rate limit headers, auto-waits, and retries on 429 (up to 3 times). No rate limit errors leak to your AI - - install from PyPI, add your API key, done.

README

以下は原文 README の抜粋です。原文を見る。

Trading 212 MCP Server

Connect your AI assistant to your Trading 212 brokerage account. Ask questions about your portfolio, place trades, manage pies, and analyze dividends - all through natural language.

Works with Claude Desktop, Claude Code, ChatGPT, Gemini, Cursor, Windsurf, and any client that supports the Model Context Protocol (MCP).

Why this server?

32 tools covering the full Trading 212 API, plus 4 analytics tools that combine multiple API calls into actionable insights
Smart rate limiting - reads T212’s rate limit headers, auto-waits, and retries on 429 (up to 3 times). No rate limit errors leak to your AI
Zero config - install from PyPI, add your API key, done. No Docker, no database, no Redis
Typed responses - every tool returns structured Pydantic models, not raw JSON
Paper trading - set ENVIRONMENT=demo to test with virtual money first

What can it do?

Category	Tools	Examples
Analytics	Portfolio summary, performance, dividends, activity	“Show me my portfolio P&L”
Trading	Market, limit, stop, stop-limit orders	“Buy 5 shares of AAPL”
Portfolio	Positions, cash balance, account info	“What’s my cash balance?”
Pies	Create, update, duplicate, delete pies	“Show my pie allocations”
Market Data	Instrument search, exchange schedules	“Search for Tesla”
History	Past orders, dividends, transactions, CSV exports	“Show my dividend history”

Analytics tools

These combine multiple API calls into single high-level responses:

fetch_portfolio_summary - Complete snapshot: total value, P&L, cash, top holdings, allocation
fetch_portfolio_performance - Per-position returns with dividends, best/worst performers
fetch_dividend_summary - Income analysis grouped by ticker and month
fetch_recent_activity - Combined timeline of trades and transactions

Quick start

Install

uvx trading212-mcp-server

Or via pip:

pip install trading212-mcp-server

Get your API credentials

From the Trading 212 app: Settings > API (Beta). You need both the API Key and Secret - the server uses Basic Auth.

GitHub で README 全文を見る

インストール

uvx trading212-mcp-server

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "trading212": {
      "command": "uvx",
      "args": ["trading212-mcp-server"],
      "env": {
        "TRADING212_API_KEY": "<your-api-key>",
        "TRADING212_API_SECRET": "<your-api-secret>",
        "ENVIRONMENT": "live"
      }
    }
  }
}