TossInvest OpenAPI MCP

Safe-by-default local stdio MCP server for the official Toss Securities / 토스증권 Open API.

Local serverstdioMIT

What is the TossInvest OpenAPI MCP Server?

TossInvest OpenAPI MCP is an MCP project maintained in the ethanklocked/tossinvest-openapi-mcp repository. The maintainer describes its purpose as “Safe-by-default local stdio MCP server for the official Toss Securities / 토스증권 Open API”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares TOSS_API_KEY, TOSS_SECRET_KEY, TOSS_ACCOUNT_SEQ. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
auth_statusaccounts
holdingsprices
orderbooktrades
price_limitscandles
stock_infostock_warnings
exchange_ratemarket_calendar
orders_openorders_closed
order_detailbuying_power
sellable_quantitycommissions
portfolio_snapshotreads holdings, KRW/USD buying power, open orders, calculable position weights, account/accountSeq state, warning flags, and partial failures. Position weights
pre_trade_checkseparate read/check layer for candidate orders; returns canProceedDryRun, realOrderBlockedByDefault, checks, warnings, blockers, missing, estimate, and…
order_previewcreates an in-memory preview contract; returns previewId, requestHash, ttlSeconds, expiresAt, exact confirmationText, estimated amount/fee/cash/quantity…
order_executefast preview-based submission; requires previewId, matching requestHash, exact confirmation (I approve this exact Toss order preview), unexpired preview, env…
order_status_summaryread-only reconciliation summary for open/recently closed orders, state counts, filled/partial/canceled/rejected/replace-related states when present, and…
order_validatechecks local gates only and never calls Toss order POST endpoints.
order_createdefaults to dry-run; real execution requires all create gates.
order_modifydefaults to dry-run; real execution requires all modify gates.
order_canceldefaults to dry-run; real execution requires all cancel gates. When ALLOWED_SYMBOLS or BLOCKED_SYMBOLS is configured, real cancellation also requires…

How to install the TossInvest OpenAPI MCP Server

{
  "mcpServers": {
    "tossinvest": {
      "command": "node",
      "args": [
        "/absolute/path/to/cloned/tossinvest-openapi-mcp/dist/index.js"
      ],
      "env": {
        "TOSS_API_KEY": "YOUR_TOSS_API_KEY",
        "TOSS_SECRET_KEY": "YOUR_TOSS_SECRET_KEY",
        "TOSS_ACCOUNT_SEQ": "${TOSS_ACCOUNT_SEQ}"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TOSS_API_KEYDeclared in the maintainer’s client configuration.Check documentation
TOSS_SECRET_KEYDeclared in the maintainer’s client configuration.Check documentation
TOSS_ACCOUNT_SEQDeclared in the maintainer’s client configuration.Optional