TradeOS AI

Usa el servidor MCP de TradeOS para integrar tus datos de trading, indicadores, lógica de estrategias y flujos de trabajo de agentes en herramientas de IA compatibles con MCP. Copia la URL de tu servidor, agrégala a GPT o Claude, y permite que tu asistente de IA trabaje directamente con tu inteligencia de trading de TradeOS.

GitHub

Prueba este MCPPatrocinado

Documentación

tradeos-mcp

TradeOS MCP te permite conectar la inteligencia de trading de TradeOS a herramientas de IA compatibles con MCP, para que tu asistente pueda analizar mercados, buscar tickers, comparar spreads, usar contexto macro y gestionar agentes de trading personalizados directamente desde indicaciones en lenguaje natural.

Resumen

Este repositorio publica @tradeos/tradeos-mcp en npm: un puente MCP stdio que envía herramientas a TradeOS Streamable HTTP (mcp-call). Puedes conectarte de dos maneras:

Modo	Mejor para	Autenticación
HTTP (recomendado)	Cursor, Claude Code, la mayoría de clientes MCP	OAuth del navegador en el cliente
npm stdio	Clientes que solo admiten `command` / stdio	Variable de entorno `TRADEOS_ACCESS_TOKEN`

Endpoint de producción (ambos modos finalmente llaman a este):

https://ai.tradeos.xyz/api/agent/mcp/mcp-call

Documentación del producto: Integración y uso de TradeOS MCP

Requisitos previos

Node.js 18+
Una cuenta de TradeOS con acceso a la API de MCP
Para npm stdio: capacidad de ejecutar una instalación local (consulta notas de Windows)

Opción A — HTTP (recomendado)

No requiere instalación de npm. El cliente gestiona OAuth.

Cursor

Edita la configuración de usuario ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json):

{
  "mcpServers": {
    "tradeos": {
      "url": "https://ai.tradeos.xyz/api/agent/mcp/mcp-call"
    }
  }
}

Guarda, reinicia Cursor (o actualiza MCP en Configuración → MCP), y luego completa OAuth cuando se te solicite.

Claude Code (plugin — recomendado)

Usa el plugin incluido en tradeos-skills/:

claude --plugin-dir ./tradeos-skills

Luego completa OAuth y ejecuta /tradeos:analyze. Flujo completo del plugin (validación, envío al marketplace de la comunidad): tradeos-skills/README.md — alineado con documentación de plugins de Claude.

Opción B — puente npm stdio

Úsalo cuando tu cliente requiera un proceso local (command + stdio).

1. Instalación local

No confíes en npx dentro de MCP en Windows (problemas de caché/rutas). Instala una vez en un directorio fijo:

mkdir -p ~/tradeos-mcp-run   # Windows: mkdir %USERPROFILE%\Downloads\tradeos-mcp-run
cd ~/tradeos-mcp-run         # Windows: cd %USERPROFILE%\Downloads\tradeos-mcp-run
npm install @tradeos/tradeos-mcp

Si prefieres, fija una versión, por ejemplo @tradeos/tradeos-mcp@1.0.0.

2. Obtén `TRADEOS_ACCESS_TOKEN`

Ejecuta el asistente OAuth (abre el navegador → inicia sesión en TradeOS → imprime el token):

# Linux / macOS
npx -y -p @tradeos/tradeos-mcp tradeos-mcp-oauth

# Or subcommand on main bin:
npx -y @tradeos/tradeos-mcp oauth

# Or, from your install directory:
node node_modules/@tradeos/tradeos-mcp/scripts/fetch-token.mjs

Windows (recomendado):

cd /d %USERPROFILE%\Downloads\tradeos-mcp-run
node node_modules\@tradeos\tradeos-mcp\scripts\fetch-token.mjs

Copia el JWT impreso (eyJ...). Para desarrollo local de este repositorio, cópialo en .env:

cp .example.env .env
# TRADEOS_ACCESS_TOKEN=eyJ...

Los usuarios finales que solo npm install el paquete no necesitan .env — en su lugar, configura el token en la configuración del cliente MCP (mcp.json).

No confirmes tokens en git.

3. Configura Cursor

{
  "mcpServers": {
    "tradeos-npm": {
      "command": "node",
      "args": [
        "C:/Users/YOU/Downloads/tradeos-mcp-run/node_modules/@tradeos/tradeos-mcp/build/index.js"
      ],
      "env": {
        "TRADEOS_ACCESS_TOKEN": "eyJ..."
      }
    }
  }
}

Reemplaza YOU y la ruta con tu ubicación real de instalación. Usa barras diagonales o barras invertidas escapadas en JSON.

Si Cursor no puede encontrar node, establece la ruta completa:

"command": "C:/nvm4w/nodejs/node.exe"

Habilita tradeos-npm en Configuración → MCP. El estado debería mostrar conectado con las herramientas listadas.

4. Verificación en terminal (opcional)

Las variables de entorno en mcp.json no se aplican a tu shell. Configura el token en la misma sesión de terminal:

REM Windows CMD
set TRADEOS_ACCESS_TOKEN=eyJ...
node C:\Users\YOU\Downloads\tradeos-mcp-run\node_modules\@tradeos\tradeos-mcp\build\index.js

# Linux / macOS
export TRADEOS_ACCESS_TOKEN=eyJ...
node ~/tradeos-mcp-run/node_modules/@tradeos/tradeos-mcp/build/index.js

Éxito:

[tradeos-mcp] remote: https://ai.tradeos.xyz/api/agent/mcp/mcp-call
[tradeos-mcp] stdio bridge ready

Presiona Ctrl+C para detener. Cursor inicia su propio proceso; no necesitas mantener esta terminal abierta.

Notas de Windows

Usa node local + ruta de instalación en mcp.json, no npx, para MCP.
Si los errores de caché de npm mencionan C:\Program Files\nodejs\node_cache, ejecuta una vez:
```
npm config set cache "%USERPROFILE%\.npm-cache"
```
npx @pkg tradeos-mcp-oauth puede ejecutar el binario incorrecto en Windows. Prefiere:
```
npx -y -p @tradeos/tradeos-mcp tradeos-mcp-oauth
```
o node .../scripts/fetch-token.mjs desde tu directorio de instalación.
Limpia una caché de npx rota (cierra Cursor primero):
```
rmdir /s /q "%USERPROFILE%\.npm-cache\_npx"
```

Referencia del paquete npm

Elemento	Valor
Paquete	`@tradeos/tradeos-mcp`
Nombre en el registro MCP	`io.github.TradeOS-AI/tradeos-mcp`
Bin: puente MCP	`tradeos-mcp`
Bin: token OAuth	`tradeos-mcp-oauth`
Subcomando OAuth	`oauth` en bin `tradeos-mcp`

Instalación:

npm install @tradeos/tradeos-mcp

Desarrollo (este repositorio)

git clone https://github.com/TradeOS-AI/tradeos-mcp.git
cd tradeos-mcp
npm ci
npm run build
npm run oauth:token    # browser OAuth → prints token (copy into .env if needed)
npm run registry:verify

Script	Propósito
`npm run build`	Compilar el puente stdio a `build/`
`npm run oauth:token`	OAuth del navegador → imprimir token
`npm run registry:verify`	Comprobaciones previas a la publicación (`package.json` ↔ `server.json`)
`npm run registry:sync-version <ver>`	Sincronizar versión desde la etiqueta de lanzamiento

Publicación (mantenedores)

Empuja una etiqueta de versión para activar .github/workflows/publish-mcp.yml:

git tag v1.0.0
git push origin v1.0.0

Las etiquetas estables (v1.0.0) publican en npm latest y en el Registro MCP.
Las etiquetas de prelanzamiento (v1.0.0-beta.1) publican con una etiqueta de distribución npm que coincide con la etiqueta de prelanzamiento (por ejemplo, beta).
Requiere el secreto de GitHub Actions NPM_TOKEN (token Automation clásico para @tradeos).

Verifica en la API del registro:

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.TradeOS-AI/tradeos-mcp"

Solución de problemas

Síntoma	Causa probable	Solución
`TRADEOS_ACCESS_TOKEN is required`	Token no configurado en env / `mcp.json`	Ejecuta el asistente OAuth; configura `env` en la configuración de MCP
`unauthorized` al conectar	Token caducado o inválido	Vuelve a ejecutar OAuth; pega un JWT nuevo (sin prefijo `Bearer`)
`EPERM` / `node_cache`	Caché de npm bajo `Program Files`	`npm config set cache "%USERPROFILE%\.npm-cache"`
`TAR_ENTRY_ERROR` / `'tradeos-mcp' is not recognized`	`npx` falló en Windows	Instalación local + ruta `node` en `mcp.json`
`MODULE_NOT_FOUND` para `node_modules/...`	Script ejecutado desde el directorio incorrecto	`cd` al directorio de instalación o usa ruta absoluta
El token funciona en terminal, no en Cursor	Ruta `mcp.json` o token no coinciden	Coincide las rutas; reinicia Cursor / actualiza MCP
MCP conecta pero no hay herramientas	Servidor incorrecto habilitado	Deshabilita entradas `localhost` rotas; usa la URL HTTP de producción o un `tradeos-npm` funcional

Relacionados

tradeos-skills/ — Plugin de Claude Code + habilidad de análisis
server.json — Manifiesto del Registro MCP
Preguntas frecuentes de TradeOS MCP (GitBook)