Trade Agent MCP Server

oficial

Ejecuta operaciones de acciones y criptomonedas a través de Trade Agent

GitHub

Documentación

Servidor MCP Trade It

👉 Documentación Completa Aquí 👈

Ahora disponible a través del Registro Oficial MCP

Tabla de contenidos

Resumen
Primeros pasos
Conexión
Herramientas
Referencia de estado de operación
IDs de corretaje (ayudantes de API)
Avisos legales

Resumen

El Servidor MCP Trade It ofrece soporte para operaciones con acciones, criptomonedas y opciones a los agentes. Permite la interacción en lenguaje natural con corretajes de acciones y criptomonedas: ejecuta operaciones, consulta el rendimiento del portafolio y obtén información del mercado enviando solicitudes en lenguaje sencillo a través del protocolo MCP.

Endpoints:

HTTP transmitible: https://mcp.tradeit.app/mcp
SSE: https://mcp.tradeit.app/sse

Soporte de Corretaje:

Soporte de Intercambio de Criptomonedas:

Coinbase
Kraken

¡Más próximamente!

Este servidor es remoto, por lo que no necesitas ejecutar nada localmente para conectarte. Solo apunta tu plataforma de agente compatible con MCP a la URL anterior.

Primeros Pasos

Primero, crea una cuenta en https://tradeit.app.
Regístrate para la prueba gratuita del plan Pro.
Conecta tu corretaje de preferencia.

Conexión

Conecta tu cliente MCP a https://mcp.tradeit.app/mcp o https://mcp.tradeit.app/sse.
Autentícate a través del flujo OAuth basado en navegador.
¡Ya estás listo para comenzar a operar!

Herramientas

Las herramientas MCP conectan tu agente a los corretajes vinculados: busca símbolos, lista cuentas, crea órdenes en borrador y luego ejecuta solo después de la confirmación.

Herramienta MCP	Qué hace
`search_assets`	Busca una acción o criptomoneda por ticker o nombre; devuelve precio y metadatos.
`get_accounts`	Lista cuentas vinculadas y saldos; también se usa al vincular un nuevo corretaje.
`create_trade`	Crea una orden de compra o venta de acciones/criptomonedas en borrador para revisión.
`create_options_trade`	Crea una orden de opciones de una o varias patas en borrador para revisión.
`execute_trade`	Envía un borrador creado previamente al corredor después de la confirmación explícita del usuario.

Modelo de seguridad (borrador primero)

Las operaciones comienzan como órdenes en draft y no se envían al corredor hasta que el usuario las confirme claramente.

Flujo previsto:

Llama a create_trade o create_options_trade → obtienes un borrador con un trade_id.
Muestra al usuario los detalles completos de la orden y cómo proceder.
Llama a execute_trade solo cuando el usuario pida explícitamente ejecutar, confirmar o colocar la operación.
No llames a execute_trade automática o inmediatamente después de crear un borrador.

Después de crear un borrador, asegúrate de que el usuario sepa que puede colocar la orden cuando esté listo (por ejemplo, a través del control Ejecutar de tu cliente, si está disponible).

Pasos opcionales antes de crear un borrador:

search_assets — confirma el ticker y el contexto.
get_accounts — elige el account_id correcto cuando al usuario le importe qué cuenta usar.

Flujo de ejecución:

User requests trade
       ↓
[Optional] search_assets — confirm ticker, get current price
       ↓
[Optional] get_accounts — identify correct account_id
       ↓
create_trade / create_options_trade → draft with trade_id, status: "draft"
       ↓
Show draft details; user confirms
       ↓
execute_trade(trade_id)
       ↓
Status: "placed" or "failed" (with details)

Valores predeterminados de cuenta/orden: Si el usuario omite el monto, la cuenta o el tipo de orden, Trade It aplica su monto predeterminado, cuenta predeterminada y órdenes de mercado cuando corresponda. Si la ejecución automática está habilitada en la configuración de Trade It, el comportamiento podría omitir el paso de ejecución manual en algunas configuraciones; en caso de duda, trata la ejecución como confirmada por el usuario.

`search_assets`

Busca una acción o criptomoneda por ticker o nombre.

Parámetro: query (cadena) — p. ej. "TSLA", "Tesla", "bitcoin".
Devuelve: Precio, ticker, bolsa, tipo de activo y metadatos relacionados.

Ejemplo:

{ "query": "TSLA" }

Ejemplos en lenguaje natural: "¿Cómo va Apple?" · "¿Cuál es el precio de TSLA?"

`get_accounts`

Lista todas las cuentas de corretaje vinculadas (y usa este flujo cuando el usuario quiera conectar un nuevo corretaje).

Parámetros: ninguno.
Devuelve: Cuentas con id, name, brokerage, balance, available_cash. Usa account.id como account_id en las llamadas de operación cuando se requiera una cuenta específica.

Ejemplo en lenguaje natural: "Muéstrame mis cuentas."

`create_trade`

Crea una orden de acciones o criptomonedas en borrador.

Parámetros:

Campo	Tipo	Requerido	Descripción
`symbol`	cadena	Sí	Ticker, p. ej. `"TSLA"`.
`amount`	número	Sí	Tamaño a operar.
`unit`	`"dollars"` o `"shares"`	Sí	Unidad para `amount`.
`buy_or_sell`	`"buy"` o `"sell"`	Sí	Dirección.
`order_type`	`"market"`, `"limit"`, `"stop"`, `"stop_limit"`	No	Predeterminado: `"market"`.
`limit_price`	número	Si es límite / stop_limit	Precio máx. o mín. por acción según corresponda.
`stop_price`	número	Si es stop / stop_limit	Precio de activación del stop.
`time_in_force`	`"day"`, `"gtc"`, `"ioc"`, `"fok"`	No	Omitir para predeterminado del corretaje.
`account_id`	número	No	Omitir para cuenta predeterminada.

Tipos de orden:

Tipo	Usar cuando	Campos de precio
`market`	Ejecutar al precio de mercado actual	Ninguno
`limit`	Solo a `limit_price` o mejor	`limit_price`
`stop`	Orden de mercado se activa a `stop_price`	`stop_price`
`stop_limit`	Orden límite se activa a `stop_price`	`stop_price` y `limit_price`

Ejemplos JSON:

Comprar $500 de Apple a mercado:

{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }

Comprar 10 acciones de NVDA solo si baja a $800 o menos:

{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }

Vender 5 acciones de Meta si el precio cae a $450 (stop):

{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }

Comprar 10 AAPL si supera los $200, pagando como máximo $202/acción:

{ "symbol": "AAPL", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "stop_limit", "stop_price": 200, "limit_price": 202 }

Comprar $1,000 de Bitcoin:

{ "symbol": "BTC", "amount": 1000, "unit": "dollars", "buy_or_sell": "buy" }

Vender 100 acciones de Tesla, válida hasta cancelar:

{ "symbol": "TSLA", "amount": 100, "unit": "shares", "buy_or_sell": "sell", "time_in_force": "gtc" }

Ejemplos en lenguaje natural: "Compra $1000 de Tesla" · "Compra $1000 de Tesla solo si el precio baja a $150 o menos" · "Vende 10 acciones de Apple si el precio cae a $140" · "Compra una acción de Apple si llega a $200" · "Compra 10 acciones de Apple si sube a $140, pero no pagues más de $142"

`create_options_trade`

Crea una orden de opciones de una o varias patas en borrador (spreads, straddles, etc.).

Parámetros:

Campo	Tipo	Requerido	Descripción
`symbol`	cadena	Sí	Ticker subyacente, p. ej. `"SPY"`.
`legs`	array	Sí	Una o más patas (ver abajo).
`direction`	`"debit"` o `"credit"`	Multi-pata	`"debit"` = tú pagas; `"credit"` = tú cobras.
`order_type`	`"market"`, `"limit"`, etc.	No	Predeterminado: `"market"`.
`limit_price`	número	Para límite	Límite de débito/crédito neto para el paquete.
`time_in_force`	`"day"` o `"gtc"`	No	Omitir para predeterminado.
`account_id`	número	No	Omitir para cuenta predeterminada.

Cada pata:

Campo	Tipo	Requerido	Descripción
`type`	`"option"` o `"equity"`	Sí	Tipo de pata.
`action`	`"buy"` o `"sell"`	Sí	Lado de la pata.
`position_effect`	`"open"` o `"close"`	Opciones	Abrir una nueva posición o cerrar una existente.
`occ`	cadena o `null`	Opciones	Cadena OCC (abajo); `null` para patas de acciones.
`quantity`	número	Sí	Contratos (opciones) o acciones (acciones).

Formato de símbolo de opción OCC

Las cadenas OCC siguen: YYMMDD + C o P + strike de 8 dígitos (strike × 1000, rellenado con ceros).

Descripción	OCC
20 jun 2025 $250 call	`250620C00250000`
20 jun 2025 $260 call	`250620C00260000`
21 mar 2025 $500 put	`250321P00500000`
19 dic 2025 $1,500 call	`251219C01500000`
16 ene 2026 $50 put	`260116P00050000`

Codificación del strike: multiplica dólares por 1,000 y rellena a 8 dígitos (p. ej. $250 → 00250000; $50.50 → 00050500).

Ejemplos JSON de opciones

Call simple — comprar 1 SPY $520 call exp 20 jun 2025:

{
  "symbol": "SPY",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00520000", "quantity": 1 }
  ]
}

Spread call alcista (débito) — comprar $250 call, vender $260 call, mismo vencimiento:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Spread put bajista (débito):

{
  "symbol": "SPY",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00520000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 }
  ]
}

Spread put alcista (crédito):

{
  "symbol": "SPY",
  "direction": "credit",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00500000", "quantity": 1 }
  ]
}

Spread con límite — débito neto $3.50 o mejor:

{
  "symbol": "TSLA",
  "direction": "debit",
  "order_type": "limit",
  "limit_price": 3.50,
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Cerrar un call largo — vender para cerrar 2 AAPL $200 calls exp 21 mar 2025:

{
  "symbol": "AAPL",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "close", "occ": "250321C00200000", "quantity": 2 }
  ]
}

Straddle — largo $250 call y $250 put, mismo vencimiento:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00250000", "quantity": 1 }
  ]
}

Ejemplos en lenguaje natural: "Compra 1 AAPL $300 call con vencimiento el próximo mes" · "Covered call en MSFT a strike $500" · "Spread call de TSLA: comprar $475 / vender $485, la próxima semana" · "Straddle ATM en SPY este viernes" · "2 puts de AMZN, límite $3.50" · "Vender AMZN260130P00200000"

`execute_trade`

Envía un borrador al corretaje después de que el usuario lo haya revisado.

Parámetro: trade_id (número) — el id del borrador de create_trade o create_options_trade.
Devuelve: Operación actualizada; estado "placed" o "failed" (con detalles del error).

Llama solo cuando el usuario confirme claramente (p. ej. ejecutar, confirmar, colocar, adelante). Confirma la operación que coincida con lo que acaban de revisar.

No llames automáticamente justo después de crear un borrador, sin mostrar los detalles de la orden, o cuando el estado no sea "draft".

Referencia de estado de operación

Estado	Significado
`draft`	Creado; aún no enviado al corredor
`pending`	Enviado; esperando confirmación del corredor
`placed`	Aceptado; esperando ejecución
`partially_filled`	Parcialmente ejecutado
`complete`	Completamente ejecutado
`canceled`	Cancelado
`failed`	Rechazado — revisar errores
`disconnected`	Problema de conexión con el corretaje

IDs de corretaje (ayudantes de API)

Corretaje	ID	Opciones
Robinhood	1	Sí
E*TRADE	2	Sí
Coinbase	3	Solo cripto
Kraken	5	Solo cripto
Charles Schwab	7	Sí
Webull	8	Sí
Public	11	Sí
Tastytrade	12	Sí

Aclaración: Pregunta una vez, con todo lo que necesites, cuando: el tipo de orden sea ambiguo (p. ej. “comprar TSLA a $200” — límite vs stop), a las opciones les falte vencimiento/strike, apliquen múltiples cuentas y no se elija ninguna, o un símbolo pueda significar más de un activo. Omite preguntas redundantes cuando los valores predeterminados sean claros (monto predeterminado, orden de mercado, cuenta principal).

Avisos legales

Invertir implica riesgo, incluyendo la posible pérdida del capital.
Trade It no es un asesor financiero y no proporciona asesoramiento de inversión.
Las opciones conllevan un riesgo sustancial y no son adecuadas para todos los inversores.
Trade It no puede retirar fondos, transferir activos ni tomar custodia — solo puede colocar operaciones a través de tus corretajes vinculados.