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.