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 tener que crear una interfaz de usuario 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.

Características clave

• Herramientas MCP listas para Claude - Utiliza 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 de API + secreto de 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 para solicitar/listar exportaciones 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

Ejecuta localmente y luego inspecciona las herramientas usando el Inspector MCP:

npx @modelcontextprotocol/inspector

Para el modo stdio, configura 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 la 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ías ver Trading 212 MCP Server running en la salida de la terminal.

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

Configuración de Claude Desktop

Usa esta configuración de servidor MCP:

{
  "mcpServers": {
    "trading212": {
      "command": "bun",
      "args": ["run", "src/server.ts"],
      "env": {
        "TRADING212_API_KEY": "your_api_key_here",
        "TRADING212_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Herramientas MCP

Cuentas

• fetch_account_cash

• fetch_account_metadata

Instrumentos

• search_exchange

• search_instrument

Cartera / Posiciones

• fetch_open_positions

• search_specific_position_by_ticker

• fetch_open_position_by_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 (watch)

• bun test src — Ejecutar pruebas en src

Solución de problemas

• Credenciales faltantes: establece TRADING212_API_KEY y TRADING212_API_SECRET.

• Errores de autenticación: regenera las credenciales de la API y reinicia el servidor.

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