toss_get_accounts
List Toss Securities accounts available to the configured Open API credentials.
LABSCO SUMMARY
Market data and account reads by default; placing real money at risk takes several deliberate switches.
Read access covers both Korean and US markets — prices, order books, candles, calendars — alongside your holdings, buying power and order history. Trading is a separate decision, and the design assumes you might not have meant it: toss_create_order, toss_modify_order and toss_cancel_order only appear with TOSSINVEST_ENABLE_TRADING=true, each call still needs confirmOrderAction: true, and sells and market orders stay blocked until TOSSINVEST_ALLOW_SELL_ORDERS and TOSSINVEST_ALLOW_MARKET_ORDERS are turned on. There is no paper-trading environment behind any of it.
What it is
A local server over the Toss Securities Open API. It runs on your own machine with your API key, covering market data and account reads; the order tools are not registered unless you enable them.
What you get
- Current prices for up to 200 comma-separated KRX or US symbols in one call, and master data for the same
- Order book, recent trades, and 1-minute or daily OHLCV candles for a single symbol
- Upper and lower price limits, and the buy warning flags on a symbol
- KRW/USD exchange rate, optionally at a given moment
- Korean and US market calendars with session hours for a given date
- Account reads: the accounts your credentials can see, holdings, buying power in KRW or USD, sellable quantity for a symbol, and commission rates
- Order history searched by status, symbol, date range and cursor, plus one specific order fetched by its ID
Requirements
A Toss Securities account with Open API access: issue an API Key and Secret Key from the Open API screen in Toss WTS and pass them as TOSSINVEST_API_KEY and TOSSINVEST_SECRET_KEY — the server will not start without both. Your machine's public IP has to be on the allowed-IP list in the same screen, or every call fails. Node.js v20 or newer; run it with npx tossinvest-mcp from the npm package tossinvest-mcp, currently 0.2.0, over stdio. OAuth tokens are issued internally and refreshed 60 seconds before they expire. Account-scoped calls default to accountSeq 1; TOSSINVEST_ACCOUNT picks a different one. There is no sandbox environment for this API.
Setup effort
One command plus a key — npx tossinvest-mcp, then supply credentials
USE CASES
01
Checking a watchlist in one go instead of symbol by symbol
Pass up to 200 comma-separated symbols and read the prices back together.
02
Working out what your account is actually holding
Read the holdings and the buying power in the right currency for the market you are looking at.
03
Looking at how a stock traded this morning
Pull 1-minute candles for the session, and the order book and recent trades for the current picture.
04
Finding out what happened to an order you placed
Search the order history by status and date range, then open the specific order by its ID.
05
Checking whether the market is even open before acting
Read the Korean or US market calendar and its session hours for the date in question.
06
Sizing a sale before you place one
Read the sellable quantity for that symbol and the commission rates on the account.
17 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
toss_get_buying_power
Get available buying power for an account. currency is required: KRW for Korean stocks, USD for US stocks.
toss_get_candles
Get 1-minute or daily OHLCV candles for one KRX or US stock symbol.
toss_get_commissions
Get trading commission information for an account.
toss_get_exchange_rate
Get KRW/USD or USD/KRW exchange rate. dateTime is optional ISO 8601.
toss_get_holdings
Get account holdings. accountSeq is optional when TOSSINVEST_ACCOUNT is configured.
toss_get_kr_market_calendar
Get Korean market calendar and session hours. date is optional YYYY-MM-DD.
toss_get_order
Fetch one specific order by its required orderId. Use toss_get_orders when you need to search or list orders by filters.
toss_get_orderbook
Get orderbook data for one KRX or US stock symbol.
toss_get_orders
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.
toss_get_price_limits
Get upper and lower price limits for one KRX or US stock symbol.
toss_get_prices
Get current prices for up to 200 comma-separated KRX or US stock symbols.
toss_get_sellable_quantity
Get sellable quantity for one symbol in an account.
toss_get_stock_warnings
Get buy warning flags for one KRX or US stock symbol.
toss_get_stocks
Get stock master data for up to 200 comma-separated KRX or US stock symbols.
toss_get_trades
Get recent trades for one KRX or US stock symbol. count defaults to the Toss API default and is capped at 50.
toss_get_us_market_calendar
Get US market calendar and session hours. date is optional YYYY-MM-DD in US local date.
BEFORE YOU INSTALL
What to know first
Tools you get
17 tools when we connected; the project documents 20. toss_create_order, toss_modify_order and toss_cancel_order register only with TOSSINVEST_ENABLE_TRADING=true. Each order then needs confirmOrderAction: true, and per-order and daily caps still apply.
Requires
- npx on PATH
- TOSSINVEST_API_KEY in your environment
- TOSSINVEST_SECRET_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx tossinvest-mcpMCP Clients
Claude Desktop, Cursor, Other MCP clients
JSON
{
"mcpServers": {
"tossinvest": {
"command": "npx",
"args": [
"tossinvest-mcp"
],
"env": {
"TOSSINVEST_API_KEY": "<YOUR_TOSSINVEST_API_KEY>",
"TOSSINVEST_SECRET_KEY": "<YOUR_TOSSINVEST_SECRET_KEY>",
"TOSSINVEST_ACCOUNT": "1"
}
}
}
}
