Toss Securities MCP (tossinvest-mcp)

Servidor MCP de Toss Securities (tossinvest-mcp)

English

Un servidor de Model Context Protocol (MCP) que permite consultar y ordenar acciones locales y estadounidenses usando tu cuenta de Toss Securities en Claude. Utiliza la API abierta de Toss Securities para consultar cotizaciones, precios de oferta y demanda, ejecuciones, gráficos, flujo de inversores, posiciones mantenidas, montos disponibles para ordenar y tipos de cambio, y registra órdenes normales y órdenes condicionales SINGLE, OCO y OTO tras un proceso de confirmación del usuario. Se puede usar directamente en clientes de IA compatibles con MCP, como Claude Code y Claude Desktop.

Generación de claves de cliente toss: https://corp.tossinvest.com/ko/open-api

Cómo usar con Claude Code

Una vez que este paquete esté publicado en npm, no es necesario clonar el repositorio. Agrega lo siguiente al .mcp.json del proyecto donde usarás Claude Code.

{
  "mcpServers": {
    "toss": {
      "command": "npx",
      "args": ["-y", "@soehd0889/tossinvest-mcp"],
      "env": {
        "TOSS_CLIENT_ID": "토스_클라이언트_ID",
        "TOSS_CLIENT_SECRET": "토스_클라이언트_시크릿"
      }
    }
  }
}

Obtén el TOSS_CLIENT_ID y el TOSS_CLIENT_SECRET desde la consola de desarrollador de la API abierta de Toss Securities, ingrésalos y reinicia Claude Code. Las credenciales no deben confirmarse en Git ni compartirse en el prompt.

npx descarga el paquete en la primera ejecución y luego usa la caché. Se requiere Node.js 18 o superior.

Herramientas disponibles

Herramienta	Descripción
toss_get_price	Consulta del precio actual de acciones coreanas y estadounidenses
toss_resolve_symbol	Convierte el nombre de una empresa a ticker o código de acción local
toss_get_holdings	Consulta de posiciones mantenidas y ganancias/pérdidas
toss_get_buying_power	Consulta del monto disponible para ordenar en KRW o USD
toss_get_exchange_rate	Consulta del tipo de cambio (predeterminado: USD → KRW)
toss_get_candles	Consulta de OHLCV en velas de 1 minuto o diarias
toss_get_orderbook / toss_get_recent_trades	Consulta de precios de oferta y demanda en tiempo real y ejecuciones recientes
toss_get_market_calendar	Consulta del horario de operación de los mercados coreano y estadounidense y días sin operación
toss_get_stock_warnings	Consulta de advertencias de inversión y alertas de negociación
toss_get_stock_investor_trading / toss_get_short_selling	Consulta del flujo de inversores y tendencias de venta en corto de acciones locales
toss_get_rankings	Consulta de rankings de volumen de negociación, volumen operado, acciones en alza y en baja
toss_get_market_indicator_prices / toss_get_market_indicator_candles	Consulta del precio actual y velas de índices e indicadores de mercado
toss_get_market_investor_trading	Consulta de montos negociados por tipo de inversor en KOSPI y KOSDAQ
toss_prepare_order	Solo valida y previsualiza órdenes de acciones (sin órdenes reales)
toss_prepare_conditional_order	Valida y previsualiza órdenes condicionales SINGLE, OCO y OTO
toss_submit_prepared_order	Envía una orden de un solo uso tras la confirmación del usuario

Procedimiento de seguridad de órdenes

Las órdenes siempre se realizan en dos pasos. toss_prepare_order o toss_prepare_conditional_order no ejecutan la orden, solo crean una vista previa. La IA debe mostrar el contenido al usuario y llamar a toss_submit_prepared_order únicamente después de recibir una confirmación explícita. El token de confirmación está vinculado exclusivamente a esa orden, expira después de 60 segundos y se invalida al usarlo una vez o al reiniciar el servidor. Esto es una medida para reducir el riesgo de órdenes erróneas y no reemplaza la revisión final del usuario.

Desarrollo local

git clone https://github.com/Jeric1223/tossinvest-mcp.git
cd tossinvest-mcp
npm install
npm test

Para ejecutar localmente, copia .env.example e ingresa las credenciales.

cp .env.example .env

Notas

• En la primera ejecución se descargan los maestros de acciones de KOSPI, KOSDAQ, NASDAQ, NYSE y AMEX; después se usa la caché y se actualiza en segundo plano una vez al día.
• Los campos numéricos de la API vienen como cadenas, y los porcentajes de cambio vienen en formato decimal. Ejemplo: -0.3799 es -37.99 %.
• Los límites de la API son 15 consultas por segundo para cotizaciones, 5 por segundo para activos y 1 por segundo para cuentas.

Aviso legal

Este proyecto es una herramienta no oficial sin relación con Toss Securities y no proporciona asesoramiento de inversión. La responsabilidad por su uso recae en el usuario.

Licencia

MIT