mcpField
T
Toss Invest

Toss Invest

Local
github.com/nukeguysFinance0Updated 5d ago
Repository

About Toss Invest

Toss Invest is a pnpm workspace containing a TypeScript SDK and local MCP server for the Toss Securities Open API. It is intended for applications using market and account APIs, with trading disabled unless explicitly enabled.

Key features

  1. 01TypeScript SDK for Toss Securities Open API
  2. 02Automatic access-token caching and refresh
  3. 03Local MCP server built on the SDK
  4. 04Trading permissions enabled by opt-in
  5. 05Read-only server by default

Use cases

  1. 01Reading market data through the Open API
  2. 02Accessing account information
  3. 03Using trading APIs after enabling permission

MCP support

The local MCP server uses the TypeScript SDK to expose Toss Securities Open API access. It is read-only by default, with trading permissions available when 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": {
    "nukeguys-toss-invest": {
      "command": "npx",
      "args": [
        "-y",
        "@nukeguys/toss-invest-mcp"
      ],
      "env": {
        "TOSS_CLIENT_ID": "<TOSS_CLIENT_ID>",
        "TOSS_CLIENT_SECRET": "<TOSS_CLIENT_SECRET>"
      }
    }
  }
}
Run commandnpx -y @nukeguys/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@nukeguys/toss-invest-mcp0.4.2

Tools

36

Saved tool list · updated 4d ago

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.