mcpField
T
Toss Invest

Toss Invest

Local
github.com/wi9ineFinance0Updated today
Repository

About Toss Invest

An unofficial TypeScript SDK and local MCP server for Toss Securities Open API, intended for clients that need market and account access. It is read-only by default, with trading available only when explicitly enabled.

Key features

  1. 01Access to market and account APIs
  2. 02Automatic access-token caching and refresh
  3. 03Local MCP server
  4. 04Read-only by default; optional trading

Use cases

  1. 01Read Toss Securities market data
  2. 02View account information
  3. 03Call trading APIs after explicitly enabling them

MCP support

The local MCP server uses the SDK to expose Toss Securities Open API to MCP clients. Access is read-only by default; trading must be explicitly enabled.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "wi9ine-toss-invest": {
      "command": "npx",
      "args": [
        "-y",
        "@wi9ine/toss-invest-mcp"
      ],
      "env": {
        "TOSS_CLIENT_ID": "<TOSS_CLIENT_ID>",
        "TOSS_CLIENT_SECRET": "<TOSS_CLIENT_SECRET>"
      }
    }
  }
}
Run commandnpx -y @wi9ine/toss-invest-mcp
Environment variables to set
TOSS_CLIENT_IDSecretToss Securities Open API client ID
TOSS_CLIENT_SECRETSecretToss Securities Open API client secret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@wi9ine/toss-invest-mcp0.3.0

Tools

29

Saved tool list · updated today

ParameterTypeRequiredDescription
symbolsarrayYesList of stock symbols. Example: ["005930", "AAPL"]

Details

From the project README

Toss Securities Open API

Unofficial community project. This project is not affiliated with or endorsed by Toss Securities.

pnpm workspace for a TypeScript SDK and a local MCP server for the Toss Securities Open API. The MCP server is read-only unless trading is explicitly enabled.

Packages

  • packages/sdk: TypeScript SDK with automatic access-token caching and refresh
  • apps/mcp: local MCP server built on the SDK, with opt-in trading permissions

Requirements

  • Node.js 22.18 or later
  • pnpm

Setup

pnpm install
cp .env.example .env

Set TOSS_CLIENT_ID and TOSS_CLIENT_SECRET in .env, then run:

pnpm check
pnpm test
pnpm test:live

The live test only performs read operations, and the MCP server defaults to read-only. See the SDK guide and MCP setup guide for usage details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.