Tossinvest MCP

@scjang01

About Tossinvest MCP

# tossinvest-mcp

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

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.

Overview

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

FAQ from Tossinvest MCP

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.

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.

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).

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.

How does order modification work?

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

Frequently asked questions

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.

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`.

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).