trading212-mcp-server
MCP server for Trading 212 - portfolio analytics, order management, pies, dividends. Works with Claude, ChatGPT, Cursor, Windsurf.
Install / Use
claude mcp add KyuRish -- npx -y github:KyuRish/trading212-mcp-serverIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of trading212-mcp-server
trading212-mcp-server scores 78/100 on our quality scale, 790th of 950 AI & Machine Learning skills we index.
Its MCP Server is 6.8 KB long, well organised into 22 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-11 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 95/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
trading212-mcp-server compared with similar skills
All 4 of these similar skills score higher than trading212-mcp-server; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| trading212-mcp-server (this skill)by KyuRish | 78 | 10 | 3mo ago | MCP Server |
| claude-memby thedotmack | 100 | 119.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.7k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install trading212-mcp-server?
- Run
claude mcp add KyuRish -- npx -y github:KyuRish/trading212-mcp-server. The install tabs above show the steps for each supported agent. - Which AI agents does trading212-mcp-server work with?
- It is written for Claude Code, Claude Desktop, Cursor and Windsurf, as a MCP Server file. Other agents that read the same format can often use it too.
- Is trading212-mcp-server safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is trading212-mcp-server still maintained?
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubTrading 212 MCP Server
<!-- mcp-name: io.github.KyuRish/trading212-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=demoto 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, allocationfetch_portfolio_performance- Per-position returns with dividends, best/worst performersfetch_dividend_summary- Income analysis grouped by ticker and monthfetch_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.
Connect to Claude Desktop
Add to claude_desktop_config.json (Windows: %APPDATA%\Claude\, Mac: ~/Library/Application Support/Claude/):
{
"mcpServers": {
"trading212": {
"command": "uvx",
"args": ["trading212-mcp-server"],
"env": {
"TRADING212_API_KEY": "<your-api-key>",
"TRADING212_API_SECRET": "<your-api-secret>",
"ENVIRONMENT": "live"
}
}
}
}
Connect to Claude Code
claude mcp add trading212 -- uvx trading212-mcp-server
Then set the environment variables in your shell or .env file.
Other clients (Cursor, Windsurf, ChatGPT, etc.)
Same command and env vars - configure per your client's MCP docs. Set ENVIRONMENT to demo for paper trading.
From source
git clone https://github.com/KyuRish/trading212-mcp-server.git
cd trading212-mcp-server
cp .env.example .env # fill in your API keys
uv sync
uv run -m trading212_mcp_server.server
<details>
<summary><code>claude_desktop_config.json</code> for source installs</summary>
{
"mcpServers": {
"trading212": {
"command": "uv",
"args": ["run", "--directory", "<path-to-repo>", "-m", "trading212_mcp_server.server"],
"env": {
"TRADING212_API_KEY": "<your-api-key>",
"TRADING212_API_SECRET": "<your-api-secret>",
"ENVIRONMENT": "live"
}
}
}
}
</details>
All 32 tools
Analytics (composite)
| Tool | Description |
|------|-------------|
| fetch_portfolio_summary | Complete portfolio snapshot with P&L and allocations |
| fetch_portfolio_performance | Per-position returns, dividends, best/worst performers |
| fetch_dividend_summary | Dividend income by ticker and month |
| fetch_recent_activity | Combined timeline of trades and transactions |
Account
| Tool | Description |
|------|-------------|
| fetch_account_info | Account metadata (currency, ID) |
| fetch_account_cash | Cash balance, invested value, P&L |
| fetch_all_open_positions | All portfolio positions with live prices |
| search_specific_position_by_ticker | Single position lookup by ticker |
Trading
| Tool | Description |
|------|-------------|
| place_market_order | Buy/sell at current market price |
| place_limit_order | Buy/sell at specified price or better |
| place_stop_order | Trigger order at stop price |
| place_stop_limit_order | Stop trigger with limit execution |
| fetch_all_orders | List all pending orders |
| fetch_order | Get specific order by ID |
| cancel_order | Cancel a pending order |
Pies
| Tool | Description |
|------|-------------|
| fetch_pies | List all investment pies |
| fetch_a_pie | Pie details with instrument allocations |
| create_pie | Create a new pie with target weights |
| update_pie | Update pie settings and allocations |
| duplicate_pie | Clone an existing pie |
| delete_pie | Remove a pie |
Market Data
| Tool | Description |
|------|-------------|
| search_instrument | Search tradeable instruments by ticker or name |
| search_exchange | Search available exchanges |
History
| Tool | Description |
|------|-------------|
| fetch_historical_order_data | Past orders with pagination |
| fetch_paid_out_dividends | Dividend payment history |
| fetch_transaction_list | Deposits and withdrawals |
| fetch_exports_list | List CSV export reports |
| request_csv_export | Request a new CSV export |
Compatibility
Tested with these MCP clients:
| Client | Status | |--------|--------| | Claude Desktop | Supported | | Claude Code | Supported | | Cursor | Supported | | Windsurf | Supported | | Any MCP-compatible client | Supported |
Author
Built by Rishabh Dogra.
Support
If this server saves you time, a coffee would mean a lot.
License
MIT
Related Skills
claude-mem
119.0kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.7kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
