Skip to main content
Glama
Trading 212 MCP Server

Trading 212 MCP Server

MCP-сервер Trading 212

Безопасный доступ к публичному API Trading 212 для Claude через MCP

Создано с использованием:

Обзор проекта

Этот проект предоставляет возможности публичного API Trading 212 в виде инструментов MCP, чтобы Claude Desktop мог безопасно запрашивать данные об аккаунте, рынке, ордерах, истории и «пирогах» (pies). Он предназначен для пользователей, которым нужен доступ к рабочим процессам портфеля на естественном языке без создания пользовательского интерфейса. Основная ценность заключается в модульной архитектуре на TypeScript, ориентированной на функции, со структурированными ошибками, строгой обработкой окружения и интеграцией MCP, ориентированной на инструменты.

Related MCP server: Trading 212 MCP Server

Ключевые особенности

  • Инструменты MCP, готовые для Claude — используйте операции Trading 212 напрямую из Claude Desktop через MCP.

  • Совместимость с публичным API — поддерживает базовую аутентификацию Trading 212 с помощью API-ключа и API-секрета.

  • Полный охват «пирогов» (Pies) — включает операции получения списка, получения по ID, создания, обновления, дублирования и удаления.

  • Рабочие процессы с ордерами — отложенные ордера, детали ордеров, размещение/отмена лимитных, рыночных, стоп- и стоп-лимитных ордеров.

  • История и экспорт — исторические ордера на основе курсора, дивиденды, транзакции и конечные точки для запроса/списка экспорта CSV.

  • Типизированная модель ошибок — согласованная обработка аутентификации, валидации, ограничений скорости, ошибок «не найдено» и ошибок API.

Демонстрация быстрого запуска

Запустите локально, затем проверьте инструменты с помощью MCP Inspector:

npx @modelcontextprotocol/inspector

Для режима stdio настройте команду Inspector следующим образом:

bun run src/server.ts

Технологический стек

  • Язык: TypeScript (строгий режим)

  • Среда выполнения: Bun 1.x (совместима с Node.js 18+)

  • MCP: @modelcontextprotocol/sdk

  • Валидация/Схема: zod

  • Конфигурация: dotenv

  • Тестирование: Bun test runner (bun test src)

Установка и настройка

Предварительные требования

  • Bun 1.0+

  • Node.js 18+

  • Учетные данные публичного API Trading 212 (TRADING212_API_KEY, TRADING212_API_SECRET)

  • Claude Desktop (для интеграции MCP)

Настройка

  1. Клонируйте репозиторий

git clone https://github.com/razeevascx/212mcp.git
  1. Перейдите в проект

cd 212mcp
  1. Установите зависимости

bun install
  1. Настройте окружение

cp .env.example .env
  1. Установите учетные данные в .env

TRADING212_API_KEY=your_api_key_here
TRADING212_API_SECRET=your_api_secret_here
ENVIRONMENT=live
TRANSPORT=stdio
LOG_LEVEL=info
DEBUG=false
  1. Соберите проект

bun run build
  1. Запустите сервер

bun run start

Проверка

  • Вы должны увидеть Trading 212 MCP Server running в выводе терминала.

  • В Claude Desktop откройте инструменты MCP и убедитесь, что инструменты Trading 212 отображаются в списке.

Конфигурация Claude Desktop

Используйте эту конфигурацию сервера MCP:

{
  "mcpServers": {
    "trading212": {
      "command": "/absolute/path/to/212mcp/start.sh"
    }
  }
}

Создайте start.sh и сделайте его исполняемым:

#!/bin/bash
set -euo pipefail
set -a
source /absolute/path/to/212mcp/.env
set +a
exec bun run /absolute/path/to/212mcp/src/server.ts

Инструменты MCP

Аккаунты

  • fetch_account_cash

  • fetch_account_metadata

Инструменты (активы)

  • search_exchange

  • search_instrument

Портфель / Позиции

  • fetch_open_positions (опциональный фильтр ticker)

Ордера

  • fetch_all_orders

  • fetch_order

  • place_limit_order

  • place_market_order

  • place_stop_order

  • place_stop_limit_order

  • cancel_order

История

  • fetch_historical_order_data

  • fetch_paid_out_dividends

  • fetch_transaction_list

  • fetch_exports_list

  • request_export_csv

Пироги (Pies)

  • fetch_pies

  • fetch_pie

  • create_pie

  • update_pie

  • duplicate_pie

  • delete_pie

Утилиты сервера

  • get_server_health

Примечания по использованию API

  • Аутентификация: Публичный API Trading 212 использует базовую аутентификацию (API_KEY:API_SECRET), обрабатываемую BaseClient.

  • Маршрутизация окружения: ENVIRONMENT=demo|live соответствует базовым URL демо/реального счета Trading 212.

  • Пагинация: Конечные точки истории используют limit + cursor и возвращают nextPagePath.

  • Ограничения скорости: API имеет ограничения по частоте запросов; ошибка 429 отображается как RATE_LIMIT_EXCEEDED.

Разработка

Скрипты

  • bun run build — компиляция TypeScript

  • bun run start — запуск сервера MCP

  • bun run dev — режим отслеживания изменений

  • bun test src — запуск тестов в src

Устранение неполадок

  • Отсутствуют учетные данные: установите TRADING212_API_KEY и TRADING212_API_SECRET.

  • Ошибки аутентификации: пересоздайте учетные данные API и перезапустите сервер.

  • Claude не может подключиться: проверьте установку Bun, путь к команде и конфигурацию MCP в Claude.

При запуске сервер проверяет конфигурацию аутентификации и немедленно завершает работу, если учетные данные неполные.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Connect Claude, ChatGPT, Codex, Claude Code or another MCP client to your real multi-broker investment portfolio. Fortunest tracks stocks, ETFs and crypto across brokers and exchanges; its MCP server lets your agent read holdings, returns, allocation, risk, trades and tax lots, calculated by Fortunest rather than guessed by the model. Reads run on their own; every change waits for your approval in the Fortunest app, and no tool places an order or moves money. Sign-in is OAuth 2.1 and needs Fortunest Pro (14-day trial, no card). A free demo that needs no account is listed as Fortunest demo.

      https://app.fortunest.ai/mcp
    • Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

      https://mcp.tradeit.app/mcp
    • Build and backtest investing strategies from your AI assistant. Remote MCP with OAuth sign-in.

      https://tactfolio.com/mcp
    • OpenFinance gives any AI agent easy trading across every major market through one hosted MCP server. Trade crypto spot and perpetuals on Hyperliquid with market, limit and TWAP orders, leverage and margin control. Trade stocks, indices, commodities, forex and pre-IPO names as Hyperliquid HIP-3 perps. Trade Polymarket prediction markets with odds, order books, positions, PnL and trader leaderboards. Swap and bridge across 40+ EVM chains and Solana with Relay and Jupiter, find memecoins across 200+ chains, launch tokens on Robinhood Chain and Solana, and buy crypto with card, bank or UPI. Write actions are designed to ask for your confirmation first. Connect with OAuth (sign in to OpenFinance and approve) or an API key. Works with Claude, ChatGPT, Cursor, VS Code, Codex and any MCP client. No install. Home: https://openfinance.tech/agents · Docs: https://docs.openfinance.tech · GitHub: https://github.com/openfinance-tech/mcp

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Trading 212 investment accounts for portfolio tracking, account management, and real-time order execution. It supports managing investment pies, analyzing historical data, and monitoring market performance across multiple instrument types.
      23
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes Trading 212 trading account, instruments, orders, history, and pies as MCP tools. Allows placing and canceling real orders (defaults to demo/paper environment).
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read a Trading 212 portfolio (balances, positions, orders, history) and place trades via the public API, supporting both demo and live environments.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Exposes Trading212 account data (summary, portfolio, cash, order history, dividends) as MCP tools, intended for direct connection to Claude.ai.
      -