MCP.so
ログイン
T

Tossinvest MCP Server

@scjang01

基本情報

カテゴリ

その他

トランスポート

stdio

作者

scjang01

投稿者

Jang Sechang

Tossinvest MCP Server について

# tossinvest-mcp

#toss#invest

Tossinvest MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "tossinvest": {
      "command": "npx",
      "args": [
        "tossinvest-mcp"
      ],
      "env": {
        "TOSSINVEST_API_KEY": "발급받은-API-Key",
        "TOSSINVEST_SECRET_KEY": "발급받은-Secret-Key",
        "TOSSINVEST_ACCOUNT": "1",
        "TOSSINVEST_ENABLE_TRADING": "false",
        "TOSSINVEST_YOLO_TRADING": "false"
      }
    }
  }
}

Tossinvest MCP Server のツール

17

Get orderbook data for one KRX or US stock symbol.

Get current prices for up to 200 comma-separated KRX or US stock symbols.

Get recent trades for one KRX or US stock symbol. count defaults to the Toss API default and is capped at 50.

Get upper and lower price limits for one KRX or US stock symbol.

Get 1-minute or daily OHLCV candles for one KRX or US stock symbol.

Get stock master data for up to 200 comma-separated KRX or US stock symbols.

Get buy warning flags for one KRX or US stock symbol.

Get KRW/USD or USD/KRW exchange rate. dateTime is optional ISO 8601.

Get Korean market calendar and session hours. date is optional YYYY-MM-DD.

Get US market calendar and session hours. date is optional YYYY-MM-DD in US local date.

List Toss Securities accounts available to the configured Open API credentials.

Get account holdings. accountSeq is optional when TOSSINVEST_ACCOUNT is configured.

Get available buying power for an account. currency is required: KRW for Korean stocks, USD for US stocks.

Get sellable quantity for one symbol in an account.

Get trading commission information for an account.

List orders for an account using filters such as status, symbol, date range, cursor, and limit. Use this for order history or open-order lists, not for fetching a known single orderId.

Fetch one specific order by its required orderId. Use toss_get_orders when you need to search or list orders by filters.

概要

What is Tossinvest MCP?

Tossinvest MCP is a local server that allows MCP-compatible apps (OpenAI, Claude Desktop, Cursor) to use the Toss Securities Open API for stock price lookup, orders, and balance inquiries. It runs only on the user's computer.

How to use Tossinvest MCP?

Install Node.js v20+, obtain API Key and Secret Key from Toss Securities WTS, and whitelist your computer’s public IP. Register the server in your MCP client’s settings using npx tossinvest-mcp as the command, passing the keys as environment variables. By default, trading tools are disabled.

Key features of Tossinvest MCP

  • Domestic/US stock price lookup
  • Order book, recent trades, and candle chart lookup
  • Currency rate and market hours inquiry
  • Account list and portfolio/holdings inquiry
  • Buyable amount, sellable quantity, and commission fee inquiry
  • Order list and detail inquiry
  • (If enabled) Create, modify, and cancel orders

Use cases of Tossinvest MCP

  • Ask AI to look up current stock prices
  • Ask AI to show your portfolio
  • Ask AI to list pending orders
  • (If enabled) Ask AI to place, modify, or cancel orders

よくある質問

1

What is the most important caution?

Toss Securities Open API has no sandbox or simulation environment. By default, order tools are not registered, and trading must be explicitly enabled.

2

What are the required environment variables?

`TOSSINVEST_API_KEY` and `TOSSINVEST_SECRET_KEY` are required. Optional variables include `TOSSINVEST_ACCOUNT`, `TOSSINVEST_BASE_URL`, `TOSSINVEST_ENABLE_TRADING`, and `TOSSINVEST_YOLO_TRADING`.

3

How do I enable trading?

Set `TOSSINVEST_ENABLE_TRADING=true` in the environment. Even then, each order tool call requires `confirmOrderAction: true` in the input unless `TOSSINVEST_YOLO_TRADING=true` (not recommended).

4

What if tools are not showing up in my MCP client?

Check JSON syntax, restart the MCP client completely, and ensure `TOSSINVEST_API_KEY` and `TOSSINVEST_SECRET_KEY` are not empty.

5

How does order modification work?

Order modification returns a new `orderId`. Use the new `orderId` for subsequent inquiries, re-modifications, or cancellations.

コメント

「その他」の他のコンテンツ