tossinvest-mcp 是一个 Model Context Protocol（MCP）服务器，目的是让用户在 Claude 等支持 MCP 的 AI 客户端中，通过 Toss Securities 账户查询韩国与美国股票并下单。它使用 Toss Securities Open API，因此需要先在 Toss Securities Open API 开发者控制台创建并获取 toss client key（TOSS_CLIENT_ID 与 TOSS_CLIENT_SECRET）。
主要能力 可查询股票行情、订单簿、成交、图表、投资者资金流、持仓、可下单金额与汇率；在通过用户确认流程后，可登记普通订单，以及 SINGLE、OCO、OTO 条件订单。适用于 Claude Code、Claude Desktop 等支持 MCP 的 AI 客户端。
使用方式 该包发布到 npm 后，使用 Claude Code 时无需克隆仓库。在项目内的 .mcp.json 中添加相应配置，并在 Toss Securities Open API 开发者控制台获取 TOSS_CLIENT_ID 和 TOSS_CLIENT_SECRET 后填入，再重启 Claude Code。凭证不应提交到 Git，也不应在提示中分享。npx 首次运行时会下载包，之后使用缓存；需要 Node.js 18 或更高版本。本地运行时，可复制 .env.example 并填入凭证。首次运行会下载 KOSPI、KOSDAQ、NASDAQ、NYSE、AMEX 的股票主数据，之后使用缓存并每天在后台更新一次。
订单确认机制 下单始终分两步进行。toss_prepare_order 或 toss_prepare_conditional_order 不会执行订单，只生成预览。AI 需向用户展示内容并在获得明确确认后，才应调用 toss_submit_prepared_order。确认令牌仅绑定那一笔订单，60 秒后过期，使用一次或服务器重启后即失效。该机制用于降低误下单风险，但不能替代用户最终检查。
注意事项与限制 API 的数字字段以字符串形式返回，涨跌幅为小数形式，例如 -0.3799 表示 -37.99%。API 限制为：行情每秒 15 次，资产每秒 5 次，账户每秒 1 次。该项目与 Toss Securities 无关，属于非官方工具，不提供投资建议，使用风险由用户自行承担。
