Skip to main content
Glama
Trading 212 MCP Server

Trading 212 MCP Server

Servidor MCP de Trading 212

Acceso seguro a la API pública de Trading 212 para Claude mediante MCP

Construido con:

Descripción general del proyecto

Este proyecto expone las capacidades de la API pública de Trading 212 como herramientas MCP para que Claude Desktop pueda consultar de forma segura datos de cuentas, mercado, órdenes, historial y "pies" (carteras automatizadas). Está dirigido a usuarios que desean acceso en lenguaje natural a sus flujos de trabajo de cartera sin necesidad de crear una interfaz personalizada. El valor principal es una arquitectura TypeScript modular basada en funciones con errores estructurados, manejo estricto del entorno e integración MCP centrada en herramientas.

Related MCP server: Trading 212 MCP Server

Características clave

  • Herramientas MCP listas para Claude - Utilice las operaciones de Trading 212 directamente desde Claude Desktop a través de MCP.

  • Autenticación compatible con API pública - Soporta autenticación básica de Trading 212 con clave API + secreto API.

  • Cobertura completa de Pies - Incluye operaciones para listar, obtener por ID, crear, actualizar, duplicar y eliminar pies.

  • Flujos de trabajo de órdenes incluidos - Órdenes pendientes, detalles de órdenes, colocar/cancelar órdenes limitadas, de mercado, stop y stop-limit.

  • Operaciones de historial + exportación - Órdenes históricas basadas en cursor, dividendos, transacciones y puntos finales de solicitud/lista de exportación CSV.

  • Modelo de error tipado - Manejo consistente de autenticación, validación, límites de tasa, no encontrado y errores de API.

Demostración de inicio rápido

Ejecute localmente y luego inspeccione las herramientas usando el Inspector MCP:

npx @modelcontextprotocol/inspector

Para el modo stdio, configure el comando del Inspector como:

bun run src/server.ts

Stack tecnológico

  • Lenguaje: TypeScript (modo estricto)

  • Runtime: Bun 1.x (compatible con Node.js 18+)

  • MCP: @modelcontextprotocol/sdk

  • Validación/Esquema: zod

  • Configuración: dotenv

  • Pruebas: Ejecutor de pruebas de Bun (bun test src)

Instalación y configuración

Requisitos previos

  • Bun 1.0+

  • Node.js 18+

  • Credenciales de la API pública de Trading 212 (TRADING212_API_KEY, TRADING212_API_SECRET)

  • Claude Desktop (para integración MCP)

Configuración

  1. Clonar el repositorio

    git clone https://github.com/razeevascx/212mcp.git
  2. Navegar al proyecto

    cd 212mcp
  3. Instalar dependencias

    bun install
  4. Configurar el entorno

    cp .env.example .env
  5. Establecer credenciales en .env

    TRADING212_API_KEY=your_api_key_here
    TRADING212_API_SECRET=your_api_secret_here
    ENVIRONMENT=live
    TRANSPORT=stdio
    LOG_LEVEL=info
    DEBUG=false
  6. Construir el proyecto

    bun run build
  7. Iniciar el servidor

    bun run start

Verificación

  • Debería ver Trading 212 MCP Server running en la salida de la terminal.

  • En Claude Desktop, abra las herramientas MCP y confirme que las herramientas de Trading 212 aparecen listadas.

Configuración de Claude Desktop

Utilice esta configuración de servidor MCP:

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

Cree start.sh y hágalo ejecutable:

#!/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

Herramientas MCP

Cuentas

  • fetch_account_cash

  • fetch_account_metadata

Instrumentos

  • search_exchange

  • search_instrument

Cartera / Posiciones

  • fetch_open_positions (filtro opcional ticker)

Órdenes

  • fetch_all_orders

  • fetch_order

  • place_limit_order

  • place_market_order

  • place_stop_order

  • place_stop_limit_order

  • cancel_order

Historial

  • 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

Utilidad del servidor

  • get_server_health

Notas de uso de la API

  • Autenticación: La API pública de Trading 212 utiliza autenticación básica (API_KEY:API_SECRET), gestionada por BaseClient.

  • Enrutamiento de entorno: ENVIRONMENT=demo|live se asigna a las URLs base de demostración/producción de Trading 212.

  • Paginación: Los puntos finales de historial utilizan limit + cursor y devuelven nextPagePath.

  • Límites de tasa: La API tiene límites de tasa; 429 se muestra como RATE_LIMIT_EXCEEDED.

Desarrollo

Scripts

  • bun run build — Compilar TypeScript

  • bun run start — Iniciar servidor MCP

  • bun run dev — Modo de vigilancia

  • bun test src — Ejecutar pruebas en src

Solución de problemas

  • Credenciales faltantes: establezca TRADING212_API_KEY y TRADING212_API_SECRET.

  • Errores de autenticación: regenere las credenciales de la API y reinicie el servidor.

  • Claude no puede conectarse: verifique la instalación de Bun, la ruta del comando y la configuración MCP de Claude.

Al iniciarse, el servidor valida la configuración de autenticación y falla rápidamente si las credenciales están incompletas.

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.
      -