Tossinvest MCP logo

Tossinvest MCP

by scjang01

Connects MCP clients to Toss Securities for market data, account queries, and guarded real-account order operations.

Install Tossinvest MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "scjang01-tossinvest-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tossinvest-mcp"
      ],
      "env": {
        "TOSSINVEST_API_KEY": "YOUR_VALUE_HERE",
        "TOSSINVEST_SECRET_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 36 tools correctly ().

Overview

The scjang01/tossinvest-mcp MCP server exposes Toss Securities Open API functions to MCP-compatible local applications. It supports Korean and U.S. stock quotes, order books, trades, candles, account data, holdings, buying power, and order queries, with optional order creation, modification, and cancellation. API credentials are supplied through environment variables, while OAuth tokens are issued and refreshed internally. Reach for it when an agent needs access to Toss Securities data or carefully guarded trading actions, but note that Toss provides no sandbox or paper-trading environment.

Use cases

  • Query Korean and U.S. stock prices from an MCP client
  • Inspect holdings, buying power, and pending orders
  • Review candles, order books, and recent trades
  • Create guarded real-account orders when trading is explicitly enabled

Key features

  • Domestic and U.S. stock market data
  • Holdings and account balance queries
  • Order list and order detail retrieval
  • Optional order creation, modification, and cancellation
  • Configurable pre-trade guardrails
  • Automatic OAuth token refresh

Tools36

What Tossinvest MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

16/18 checks healthy over the last 104d

What it can do

From the 36 tools this server returned when we ran it; 36 declare their own safety hints.

Handles credentials · 1Makes network requests · 36Read-only tools · 36
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age173 days
Maintainers1

Observed 2026-11-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7h ago via OSV.dev · tossinvest-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads589Package downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed36Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Tossinvest MCP works

What scjang01/tossinvest-mcp MCP server does

The scjang01/tossinvest-mcp MCP server connects MCP clients running on a user’s computer to the Toss Securities Open API. Its read-only capabilities cover domestic and U.S. stock information, including current prices, order books, recent trades, candles, upper and lower price limits, basic instrument details, purchase warnings, exchange rates, and market hours.

Account-oriented queries include available accounts, holdings, buying power, sellable quantities, trading fees, order lists, and order details. These functions are available without enabling trading. The default account is account sequence 1, and another account can be selected through configuration.

Trading is optional. When enabled, the server registers tools for creating, modifying, and cancelling orders. A modification replaces the original order rather than patching it in place, so Toss returns a new order ID that must be used for later lookups, modifications, or cancellation.

How it works

The scjang01/tossinvest-mcp MCP server runs locally through Node.js and communicates with the MCP client over its local process connection. The npm package can be launched with npx, allowing the client to fetch it when first started. Toss Securities API credentials are passed as environment variables rather than written into tool requests.

OAuth token handling is internal: the server obtains tokens and refreshes them automatically before expiry. Toss Securities only accepts requests from registered IP addresses, so the machine’s public IP must be added to the allowed IP list in the Toss Securities WTS Open API settings.

Trading tools are not registered by default. If trading is enabled, each create, modify, or cancel request normally also needs the input field confirmOrderAction: true. This confirmation requirement can be disabled for automation, but other configured restrictions continue to apply.

Setup and configuration

Install Node.js 20 or newer, obtain a Toss Securities API Key and Secret Key, and register the machine’s public IP with Toss Securities. Add the server to the MCP client configuration with npx tossinvest-mcp, setting TOSSINVEST_API_KEY and TOSSINVEST_SECRET_KEY in the environment.

TOSSINVEST_ACCOUNT selects the default account sequence and otherwise defaults to 1. Set TOSSINVEST_ENABLE_TRADING to true only when real-account order operations are intended. The scjang01/tossinvest-mcp MCP server does not provide a sandbox, so initial testing should use market-data and account-query functions before enabling trading.

Tools and capabilities

The scjang01/tossinvest-mcp MCP server supports:

  • Domestic and U.S. stock quotes, order books, trades, candles, and instrument information
  • Exchange rates and domestic/U.S. market schedules
  • Account lists, holdings, buying power, sellable quantities, fees, and order details
  • Optional order creation, modification, and cancellation
  • Local pre-trade restrictions for order amount, daily amount, daily count, symbols, selling, market orders, and account selection

Limitations and notes

All order operations can affect a real Toss Securities account. There is no documented mock-trading or sandbox environment. By default, selling and market orders are blocked, and order confirmation is required. Additional limits can restrict one-order amounts, daily totals, daily order counts, permitted symbols, and the account used for orders.

The server requires valid Toss Securities credentials and an allowed source IP. Protect the API Key and Secret Key. Account-dependent requests use the configured default account unless a supported request specifies otherwise, and account locking can prevent orders from targeting a different account.

Written by AllMCPs with AI assistance from the project’s README and listing data. How we build listings

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tossinvest MCP

Install Node.js 20 or newer, then configure the MCP client to run `npx tossinvest-mcp` with `TOSSINVEST_API_KEY` and `TOSSINVEST_SECRET_KEY`.

Yes. The README identifies Claude Desktop as an MCP-compatible application for this local server.

No. Toss Securities Open API has no sandbox or simulated-investment environment, so enabled trading can send orders to a real account.

Set `TOSSINVEST_ENABLE_TRADING` to `true`. Order requests normally also need `confirmOrderAction: true`; amount, symbol, account, selling, and market-order guardrails can be configured separately.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTossinvest MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/scjang01-tossinvest-mcp?style=directory)](https://allmcps.com/mcp/scjang01-tossinvest-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/scjang01-tossinvest-mcp"><img src="https://allmcps.com/api/badge/scjang01-tossinvest-mcp?style=directory" alt="Tossinvest MCP on AllMCPs" /></a>