股票数据 MCP Server
悟道 A股股票数据 MCP 用一个远程地址提供 63 个 A股工具:57 个只读查询,覆盖行情、涨停梯队、题材资金、集合竞价、龙虎榜、事件日历、基本面和官方披露;另有 6 个管理用户本人自选股的工具。Agent 用 tools/list 发现工具,用 tools/call 拿到结构化结果。
一个地址、一个请求头
| 服务地址 | https://stock.quicktiny.cn/api/mcp |
|---|---|
| 传输方式 | 远程 HTTP(Streamable HTTP,无状态,POST JSON-RPC);不提供 stdio |
| 认证 | Authorization: Bearer YOUR_API_KEY,在 开发者控制台 创建;平台保留 Authorization 时改用 X-API-Key: YOUR_API_KEY |
| 协议版本 | 2025-11-25、2025-06-18、2025-03-26、2024-11-05 |
| 工具分组 | 默认 all;可用 ?profile= 或 X-MCP-Profile 只加载 market_replay、stock_research、auction_review 等分组 |
| 机器可读清单 | https://stock.quicktiny.cn/api/mcp/manifest |
| 额度 | 免费每天 50 次,付费 ¥1,000/年起,见 价格与限制 |
{
"mcpServers": {
"wudao-stock-data": {
"type": "streamableHttp",
"url": "https://stock.quicktiny.cn/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}不同客户端的写法不一样:Claude Code、Cursor、Codex、OpenClaw 和 Hermes 见 接入文档,WorkBuddy 见 WorkBuddy 接入指南。
63 个工具,按 11 类整理
只读工具只查询数据;标为“写入”的 6 个工具只修改当前 Key 所属用户的自选股和分组。工具参数、返回字段和最新增减以 manifest 为准。
行情与市场(9 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
stock_search | 股票搜索 | 按名称、代码、拼音或行业关键词定位股票代码 | 只读 |
kline | K 线 | 个股日 K,可选前复权,盘中融合最新行情 | 只读 |
minute_data | 分时 | 个股实时或指定交易日的分时价格、均价和成交量 | 只读 |
stock_rank | 股票排行 | 涨幅、跌幅、成交额、换手率等实时排行 | 只读 |
market_overview | 市场概况 | 全市场涨跌家数、市场温度等宽度数据 | 只读 |
trading_calendar | 交易日历 | 判断指定日期是否为 A股交易日 | 只读 |
index_market | 指数行情 | 指数搜索、实时快照、排行、日线和分钟线 | 只读 |
etf_market | ETF 行情 | ETF 搜索、实时快照、排行、日线和分钟线 | 只读 |
convertible_bond_market | 可转债行情 | 可转债搜索、正股映射、快照、排行、K 线和转股溢价率 | 只读 |
涨停生态(11 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
limit_up_ladder | 涨停梯队 | 按连板高度分层的涨停股、题材主类排行和晋级率 | 只读 |
limit_up_filter | 涨停筛选 | 按日期区间、连板数、题材、行业、市值、封单等条件筛选涨停记录 | 只读 |
limit_up_premium | 涨停溢价 | 涨停股次日溢价统计与排行 | 只读 |
broken_limit_up | 炸板池 | 当日触及涨停但未封住的股票,含开板次数 | 只读 |
limit_down | 跌停池 | 当日跌停股票与封单 | 只读 |
approaching_limit_up | 冲刺涨停 | 涨幅接近涨停但尚未封板的股票 | 只读 |
limit_stats | 涨跌停统计 | 封板数、炸板数、封板率,以及与前一交易日的对比 | 只读 |
limit_events | 封板/炸板事件流 | 带秒级时间戳的封板和炸板事件 | 只读 |
limit_event_summary | 封板/炸板事件摘要 | 首封最早、炸板最多、回封最多和尾盘事件 | 只读 |
board_break_analysis | 断板分析 | 昨日涨停股在今日的表现 | 只读 |
short_term_emotion | 短线情绪 | 涨跌停、炸板率、晋级率、一字封单和市场宽度快照 | 只读 |
资金与板块(7 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
capital_flow | 资金流向 | 个股、大盘和北向的日频资金流 | 只读 |
intraday_main_flow | 盘中个股主力资金 | 盘中主力资金快照,可按代码池过滤 | 只读 |
theme_intraday_capital | 盘中板块资金 | 题材和板块强度、主力资金,支持盘中资金曲线 | 只读 |
theme_stocks | 题材成分股 | 题材或板块的成分股下钻 | 只读 |
sector_analysis | 板块轮动 | 动量 × 强度四象限分析 | 只读 |
anomaly_detection | 异动检测 | 按交易所规则检测价格偏离异动 | 只读 |
stock_screener | 条件选股 | 按题材、行业、价格、市值、涨跌幅、换手、估值等条件筛选 | 只读 |
集合竞价(4 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
auction_market_scan | 竞价全市场扫描 | 按竞价金额、涨停委买、涨幅、量比排序过滤 | 只读 |
auction_opening_snapshot | 竞价全景快照 | 竞价涨跌停、委买额前列、昨日炸板和涨停股今日表现等六个视图 | 只读 |
auction_theme_strength | 竞价题材强度 | 按题材聚合竞价额、平均涨幅、高开数量和龙头候选 | 只读 |
auction_data | 竞价明细 | 指定股票的集合竞价数据,含历史分位、量比和涨停委买额 | 只读 |
市场情报与资讯(6 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
dragon_tiger | 龙虎榜 | 上榜股票与买卖席位 | 只读 |
research_reports | 研报 | 个股评级、目标价和盈利预测 | 只读 |
smart_hotlist | 股票热榜 | 多平台综合的股票热度榜 | 只读 |
news_hotlist | 资讯热榜 | 财经热点与媒体热榜 | 只读 |
cls_news | 实时快讯 | 快讯原文,可按关键词、股票、消息级别和时间过滤 | 只读 |
briefings | 每日简报 | 早盘、午盘、收盘和晚间的市场简报 | 只读 |
事件与日历(4 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
stock_event_calendar | 公司事件/风险日历 | 解禁、增减持、回购、分红除权和财报披露计划 | 只读 |
unlock_events | 限售解禁 | 个股或全市场的解禁日期、股份和比例 | 只读 |
market_catalyst_calendar | 短线催化日历 | 政策会议、行业大会、产品发布、指数调整等未来事件 | 只读 |
macro_calendar | 宏观财经日历 | 全球经济数据与央行事件 | 只读 |
基本面(5 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
valuation_snapshot | 估值快照 | 估值、市值、换手率和股息率 | 只读 |
financial_summary | 财务摘要 | 三大报表、财务指标、审计意见和主营构成 | 只读 |
shareholder_structure | 股东结构 | 十大股东、股东户数、质押、分红和回购 | 只读 |
margin_trading | 融资融券 | 市场汇总或个股明细 | 只读 |
northbound_holdings | 北向持股 | 沪深股通持股明细 | 只读 |
官方披露(3 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
official_announcements | 官方公告 | 上市公司正式公告检索 | 只读 |
official_interactions | 互动问答 | 交易所投资者互动平台上的问答 | 只读 |
official_disclosure_evidence | 官方披露证据包 | 单只股票的公告与互动问答汇总 | 只读 |
海外披露(3 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
sec_company_search | SEC 公司检索 | 按美股代码或公司名查找 CIK | 只读 |
sec_filings | SEC 披露列表 | 10-K、10-Q、8-K 等表单 | 只读 |
sec_company_facts | SEC 财务事实 | XBRL 财务事实 | 只读 |
复盘工作流(3 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
market_replay_workflow | 市场复盘工作流 | 一次返回交易日、市场概况、涨跌停、梯队、题材排行和简报 | 只读 |
limitup_review_workflow | 涨停复盘工作流 | 一次返回涨跌停统计、梯队、题材、炸板池和跌停池 | 只读 |
stock_research_workflow | 个股研究工作流 | 一次返回搜索、K 线、资金、研报和龙虎榜,可附估值与财务 | 只读 |
自选股管理(8 个)
| 工具名 | 名称 | 用途 | 读写 |
|---|---|---|---|
watchlist_list | 自选股列表 | 读取本人的自选股、分组、标签和备注 | 只读 |
watchlist_group_list | 自选股分组列表 | 读取本人的自选股分组 | 只读 |
watchlist_add | 加入自选股 | 把用户明确指定的股票加入本人自选 | 写入(本人自选) |
watchlist_remove | 移除自选股 | 从本人自选中移除指定股票 | 写入(本人自选) |
watchlist_update_stock | 更新自选股条目 | 修改自选股的分组、标签或备注 | 写入(本人自选) |
watchlist_group_create | 创建自选股分组 | 新建空分组 | 写入(本人自选) |
watchlist_group_rename | 重命名自选股分组 | 修改分组名称 | 写入(本人自选) |
watchlist_group_delete | 删除自选股分组 | 删除指定分组 | 写入(本人自选) |
常见任务用哪几个工具
| 任务 | 工具组合 |
|---|---|
| 收盘复盘 | trading_calendar → market_replay_workflow,或分步用 market_overview、limit_stats、limit_up_ladder、theme_intraday_capital |
| 涨停与情绪 | limitup_review_workflow、board_break_analysis、short_term_emotion、limit_up_premium |
| 开盘前竞价 | auction_opening_snapshot、auction_market_scan、auction_theme_strength |
| 个股研究 | stock_research_workflow,再按需补 financial_summary、official_disclosure_evidence |
| 盘前排雷 | stock_event_calendar、unlock_events、market_catalyst_calendar |
| 自选股观察 | watchlist_list → kline、capital_flow;用户明确要求时才用 watchlist_add 等写入工具 |
五次查询生成一份收盘复盘
完整报告、请求参数和公开 JSON,可以照着复现。
和抓网页、自己封装 API 比,差在哪里
| 抓网页 | 传统 REST / Python 接口 | MCP 工具层 | |
|---|---|---|---|
| 工具发现 | 没有 | 靠文档,需要自己写工具说明 | tools/list 直接返回名称、参数和说明 |
| 参数约束 | 没有 | 代码里自行校验 | JSON Schema 约束,错参数返回 INVALID_ARGUMENTS |
| 返回结构 | 页面文本,改版就失效 | 结构化,字段各家不同 | 结构化,并带交易日、日期状态和质量提示 |
| 维护成本 | 高 | 中,要自己维护包装层 | 低,服务端统一维护 |
如果你已经有 Tushare 数据资产,或要做长周期历史研究和量化回测,Tushare、AkShare、Baostock 往往更合适,可以和 MCP 工具层组合使用。完整选型见 股票数据源怎么选 和 股票数据 MCP 有哪些。
它能做什么、不能做什么
- 不执行交易下单,不提供投资建议或收益承诺。
- 写入只限当前用户本人的自选股和分组。
- 只提供远程 HTTP MCP,没有 stdio 版本;不支持远程 MCP 的平台需要 HTTP 工具或适配层。
- 数据按交易日节奏更新。回答前应看返回里的
tradeDate、dateStatus和qualityWarnings,日期不一致时不要把旧数据说成当天数据,见 数据状态说明。
常见问题
悟道 MCP 有多少个工具?
63 个工具:57 个只读查询,6 个管理用户本人自选股。完整清单以线上 manifest 和 tools/list 为准,本页核对日期为 2026-10-06。
写入类工具会动我的什么数据?
只会修改当前 API Key 所属用户本人的自选股和分组,例如加入、移除股票或重命名分组。悟道不执行交易下单。
需要本地安装或 stdio 吗?
不需要,也不提供 stdio 模式。悟道只提供远程 HTTP MCP,客户端填写服务地址和 Bearer API Key 即可。
不支持远程 MCP 的平台怎么办?
扣子支持 MCP 类型插件,按扣子接入的步骤配置即可(授权用 Header X-API-Key);豆包等不支持远程 MCP 的环境,可以通过 HTTP 工具或自建适配层调用 REST 兼容入口 https://stock.quicktiny.cn/api/openclaw,额度与 MCP 共用。
能只加载一部分工具吗?
可以。在地址后加 ?profile=market_replay 等分组参数,或在请求头传 X-MCP-Profile;默认 all 返回全部工具。