Toss Securities MCP (tossinvest-mcp)

No Claude, usando uma conta da Toss Securities, consulte cotações e saldos de ações nacionais e dos EUA, e registre ordens condicionais SINGLE, OCO e OTO. Todas as ordens passam por um token de confirmação de uso único com expiração de 60 segundos.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP do Toss Securities (tossinvest-mcp)

Inglês

Este é um servidor Model Context Protocol (MCP) que permite consultar e negociar ações domésticas e americanas usando sua conta Toss Securities no Claude. Usando a API Aberta do Toss Securities, consulta cotações, cotações de oferta, execuções, gráficos, fluxo de investidores, posições, saldo disponível e taxas de câmbio, e registra ordens regulares e ordens condicionais SINGLE, OCO e OTO após procedimento de confirmação do usuário. Pode ser usado imediatamente em clientes de IA compatíveis com MCP, como Claude Code e Claude Desktop.

Geração de chave de cliente toss: https://corp.tossinvest.com/ko/open-api

Como usar no Claude Code

Depois que este pacote for publicado no npm, não é necessário clonar o repositório. Adicione o seguinte conteúdo ao .mcp.json do projeto onde você usará o Claude Code.

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

No console do desenvolvedor da API Aberta do Toss Securities, emita a TOSS_CLIENT_ID e a TOSS_CLIENT_SECRET, insira-as e reinicie o Claude Code. As credenciais não devem ser commitadas no Git nem compartilhadas no prompt.

npx baixa o pacote na primeira execução e usa o cache depois disso. É necessário Node.js 18 ou superior.

Ferramentas fornecidas

Ferramenta	Descrição
`toss_get_price`	Consulta o preço atual de ações coreanas e americanas
`toss_resolve_symbol`	Converte nome de empresa em ticker ou código de ação doméstica
`toss_get_holdings`	Consulta posições e lucros/perdas
`toss_get_buying_power`	Consulta o valor disponível para ordens em won ou dólar
`toss_get_exchange_rate`	Consulta taxa de câmbio (padrão: USD → KRW)
`toss_get_candles`	Consulta OHLCV de velas de 1 minuto ou diárias
`toss_get_orderbook` / `toss_get_recent_trades`	Consulta cotações de oferta em tempo real e execuções recentes
`toss_get_market_calendar`	Consulta horários de funcionamento dos mercados coreano e americano e dias sem negociação
`toss_get_stock_warnings`	Consulta avisos de risco de investimento e alertas de negociação
`toss_get_stock_investor_trading` / `toss_get_short_selling`	Consulta fluxo de investidores e tendências de venda a descoberto de ações domésticas
`toss_get_rankings`	Consulta rankings de maior volume de negociação, volume, altas e baixas
`toss_get_market_indicator_prices` / `toss_get_market_indicator_candles`	Consulta preço atual e velas de índices e indicadores de mercado
`toss_get_market_investor_trading`	Consulta valores de negociação por tipo de investidor no KOSPI e KOSDAQ
`toss_prepare_order`	Apenas valida e pré-visualiza ordens de ações (sem envio real)
`toss_prepare_conditional_order`	Valida e pré-visualiza ordens condicionais SINGLE, OCO e OTO
`toss_submit_prepared_order`	Envia uma ordem única após confirmação do usuário

Procedimento de segurança para ordens

As ordens sempre são executadas em duas etapas. toss_prepare_order ou toss_prepare_conditional_order não executam ordens, apenas criam uma pré-visualização. A IA deve mostrar o conteúdo ao usuário e chamar toss_submit_prepared_order somente após receber confirmação explícita. O token de confirmação está vinculado exatamente àquela ordem, expira após 60 segundos e é invalidado após uso único ou reinicialização do servidor. Isso é um mecanismo para reduzir o risco de ordens errôneas e não substitui a revisão final do usuário.

Desenvolvimento local

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

Ao executar localmente, copie .env.example e insira as credenciais.

cp .env.example .env

Observações

Na primeira execução, são baixados os master de ações do KOSPI, KOSDAQ, NASDAQ, NYSE e AMEX; depois, usa-se o cache, com atualização em segundo plano uma vez por dia.
Os campos numéricos da API vêm como strings, e a variação percentual está em formato decimal. Exemplo: -0.3799 é -37,99%.
Os limites da API são: 15 chamadas por segundo para cotações, 5 por segundo para ativos e 1 por segundo para contas.

Aviso de isenção

Este projeto é uma ferramenta não oficial, sem relação com o Toss Securities, e não fornece aconselhamento de investimento. A responsabilidade pelo uso é do usuário.

Licença

MIT