tossinvest-openapi-mcp 是一个 MCP（Model Context Protocol）服务器，面向开发者与 AI 智能体，帮助其浏览、探索并接入 Toss Securities Open API（Toss 证券开放 API）的规范文档。项目由 JeongSeongMok 发布在 GitHub。
用途：该服务器内嵌 Toss 证券 OpenAPI 规范，并以 MCP 工具形式提供给 AI 编程代理。它定位为只读的文档与探索服务器，不调用真实 API、不执行订单，也不要求任何认证信息。适合刚开始接入 Toss 证券 Open API 的开发者，用于快速了解端点、认证、下单与行情 API 的结构，并可借助 AI 代理生成代码。
主要能力：连接到 MCP 客户端后，代理可以：探索 Toss 证券 Open API 的所有端点与分类；查看请求/响应 schema 与示例；按关键词搜索端点与数据模型；使用以用例为中心的集成指南，覆盖认证、行情与标的、市场指标、排行榜、资金流向、账户与资产、订单、条件订单；生成 curl / TypeScript / Python 请求代码示例。内嵌规范版本为 v1.2.17，包含 13 个分类、36 个端点、90 个数据模型。
使用方式：该服务器通过 stdio 方式通信。运行环境需要 Node.js 18+，可直接通过 npx -y tossinvest-openapi-mcp 运行。也可使用 GitHub 命令，直接克隆、构建并运行仓库，以获取最新源码。将所选执行命令对应的配置块粘贴到 MCP 客户端配置中即可。支持 MCP 的客户端包括 Claude Desktop、Claude Code、Cursor、Codex CLI 等。配置位置：Claude Desktop 为 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json；Claude Code 为项目中的 .mcp.json，或执行 claude mcp add tossinvest-openapi -- npx -y tossinvest-openapi-mcp；Codex CLI 为 ~/.codex/config.toml（使用 TOML 格式）；Cursor 为 ~/.cursor/mcp.json。修改配置后重启客户端，相关工具即会暴露给代理。Toss 证券 OpenAPI 文档位于仓库根目录的 openapi.json，并随发布包一同打包；如需更新规范，替换该文件并重新构建即可。
适用场景：适合用于 Toss 证券 Open API 的文档查询、端点与数据模型检索、集成指南学习，以及借助 AI 代理生成请求示例代码。
限制：该工具是描述 Toss 证券公开 OpenAPI 文档的非官方工具，不进行真实交易执行、不访问账户、不传输认证信息。正式在生产环境应用前，必须通过 Toss 证券 Open API 官方文档进行验证。除上述内容外，其他细节暂未提供。
