# Wudao A-Share Stock Data MCP

> China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.

- name: io.github.jcdreamjc/wudao-mcp
- version: 1.1.0
- connection class: R1 (autonomous)
- trust: 97/100
- quality: 83/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.jcdreamjc%2Fwudao-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.jcdreamjc%2Fwudao-mcp/tools

**An agent can connect on its own if it already holds `WUDAO_MCP_TOKEN`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "wudao-mcp": {
      "type": "http",
      "url": "https://stock.quicktiny.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer ${WUDAO_MCP_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${WUDAO_MCP_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% +updated-15d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 83/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 63 of 63 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- warn `tools.token_cost`: about 22,983 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 126 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 63, about 22,983 tokens to load them all
- tool set hash: ec283d0e65f4930c07c272a49b2aa552
- tools last changed: 2026-10-08T08:35:46.232Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.jcdreamjc/wudao-mcp.svg)](https://protogrid.dev/servers/io.github.jcdreamjc/wudao-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-08 `watchlist_update_stock` changed (description, inputSchema)
  - before: 更新当前 API key 所属用户自选股条目的分组、标签、备注或来源上下文。写入工具，仅在用户明确要求移动股票分组、打标签或改备注时使用。 何时使用: 更新当前 API key 所属用户自选股条目的分组、标签、备注。groupMode=add 可把股票追加到新分组且保留原分组；replace 才是移动到新分组。适合用户说"把这些票移到某组/打标签/改备注"。 【链接】响应中 rows[i] / items[i] / 嵌套股票列表里的每个对象都含 code/name 字段。最终回答中列举具体股票时必须按 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` 格式输出 markdown 链接（例：`[贵州茅台(600519)](https://stock.quicktiny.cn/quote/600519)`），让用户能点击查看行情；不要简化为「名称 + 代码」纯文本。
  - after: 更新当前 API key 所属用户自选股条目的分组、标签、备注或来源上下文。写入工具，仅在用户明确要求移动股票分组、打标签或改备注时使用。 何时使用: 更新当前 API key 所属用户自选股条目的分组、标签、备注。groupMode=add 可把股票追加到新分组且保留原分组；replace 才是移动到新分组。适合用户说"把这些票移到某组/打标签/改备注"。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- 2026-10-08 `watchlist_remove` changed (description, inputSchema)
  - before: 从当前 API key 所属用户的私有自选股中移除用户明确指定的股票。写入工具，仅在用户明确要求删除/移除时使用。 何时使用: 从当前 API key 所属用户的自选股中移除股票。只有用户明确要求移除/删除自选时调用。 【链接】响应中 rows[i] / items[i] / 嵌套股票列表里的每个对象都含 code/name 字段。最终回答中列举具体股票时必须按 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` 格式输出 markdown 链接（例：`[贵州茅台(600519)](https://stock.quicktiny.cn/quote/600519)`），让用户能点击查看行情；不要简化为「名称 + 代码」纯文本。
  - after: 从当前 API key 所属用户的私有自选股中移除用户明确指定的股票。写入工具，仅在用户明确要求删除/移除时使用。 何时使用: 从当前 API key 所属用户的自选股中移除股票。只有用户明确要求移除/删除自选时调用。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- 2026-10-08 `watchlist_add` changed (description, inputSchema)
  - before: 把用户明确指定的股票加入当前 API key 所属用户的私有自选股，支持批量、去重、自动分组、标签和备注。写入工具，仅在用户明确要求加入自选时使用。 何时使用: 把用户明确指定的一只或多只股票加入当前 API key 所属用户的自选股。自选总数最多 300 只，每组最多 50 只；同一股票可属于多个组。支持股票名称/代码混输、批量去重、自动分组（连板/首板/题材/行业）和备注标签。只有用户明确要求"加入自选/加到观察池/帮我收藏这些票"时调用。 【链接】响应中 rows[i] / items[i] / 嵌套股票列表里的每个对象都含 code/name 字段。最终回答中列举具体股票时必须按 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` 格式输出 markdown 链接（例：`[贵州茅台(600519)](https://stock.quicktiny.cn/quote/600519)`），让用户能点击查看行情；不要简化为「名称 + 代码」纯文本。
  - after: 把用户明确指定的股票加入当前 API key 所属用户的私有自选股，支持批量、去重、自动分组、标签和备注。写入工具，仅在用户明确要求加入自选时使用。 何时使用: 把用户明确指定的一只或多只股票加入当前 API key 所属用户的自选股。自选总数最多 300 只，每组最多 50 只；同一股票可属于多个组。支持股票名称/代码混输、批量去重、自动分组（连板/首板/题材/行业）和备注标签。只有用户明确要求"加入自选/加到观察池/帮我收藏这些票"时调用。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- 2026-10-08 `watchlist_group_delete` changed (inputSchema)
- 2026-10-08 `watchlist_group_rename` changed (inputSchema)
- 2026-10-08 `watchlist_group_create` changed (inputSchema)
- 2026-10-08 `watchlist_group_list` changed (inputSchema)
- 2026-10-08 `watchlist_list` changed (description, inputSchema)
  - before: 读取当前 API key 所属用户的私有自选股列表，返回分组、标签、备注和最近涨停上下文。只读工具。 何时使用: 读取当前 API key 所属用户的自选股列表，可按 groupName 筛选，并返回分组、标签、备注和最近涨停上下文。只在用户明确问"我的自选/自选股列表/观察池"时使用。 【链接】响应中 rows[i] / items[i] / 嵌套股票列表里的每个对象都含 code/name 字段。最终回答中列举具体股票时必须按 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` 格式输出 markdown 链接（例：`[贵州茅台(600519)](https://stock.quicktiny.cn/quote/600519)`），让用户能点击查看行情；不要简化为「名称 + 代码」纯文本。
  - after: 读取当前 API key 所属用户的私有自选股列表，返回分组、标签、备注和最近涨停上下文。只读工具。 何时使用: 读取当前 API key 所属用户的自选股列表，可按 groupName 筛选，并返回分组、标签、备注和最近涨停上下文。只在用户明确问"我的自选/自选股列表/观察池"时使用。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- 2026-10-08 `sec_company_facts` changed (inputSchema)
- 2026-10-08 `sec_filings` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/io.github.jcdreamjc%2Fwudao-mcp/changes

## Remotes

- https://stock.quicktiny.cn/api/mcp (streamable-http, auth api_key ${WUDAO_MCP_TOKEN}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (63)

- `anomaly_detection`: 按交易所规则检测个股价格偏离基准指数的异动：3日偏离±20%/±30%（主板/双创），主板风险警示股历史按生效日切换旧/新口径，10日严重异动等，自动区分板块阈值 何时使用: 监管口径异动和风险提示；主板风险警示股票按规则生效日自动切换旧/新异常波动口径。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `approaching_limit_up`: 实时监测涨幅接近涨停但尚未封板的个股，盘中捕捉潜在涨停机会 何时使用: 仅用于当日盘中冲刺涨停监控，不支持历史日期；盘前/非交易日会返回明确状态而不是空报错。配合 minute_data。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `auction_data`: 集合竞价阶段逐笔数据，含历史分位、量比、涨停委买额和 20 分后涨停委买额，开盘前发现异动信号 何时使用: 单股/多股集合竞价明细（必须传 code/codes）。全市场排行→auction_market_scan；题材聚合→auction_theme_strength；昨涨停/昨炸板今表现→auction_opening_snapshot。
- `auction_market_scan`: 全市场按集合竞价金额、涨停委买、封单、涨幅、量比等排序过滤。昨涨停/昨炸板今表现请用 auction_opening_snapshot；题材聚合用 auction_theme_strength。当日 9:25 前会提示未就绪。 何时使用: 竞价主扫描器：按强度/成交额/涨停委买/尾秒竞价涨幅/封单等排序过滤。昨涨停与昨炸板反馈用 auction_opening_snapshot；题材线用 auction_theme_strength。未传日期且今天非交易日时按交易日历查询上一交易日并标注实际日期；交易日当日 9:25 前会提示未就绪。
- `auction_opening_snapshot`: 一次返回六个固定竞价视图：竞价涨停、竞价跌停、涨停委买额前 N、竞价成交额前 N、昨日炸板今表现、昨日涨停今表现。每行保留完整竞价字段，适合开盘后快速复盘和生成观察名单。 何时使用: 竞价全景快照：一次返回八个固定视图——竞价涨停、竞价跌停、涨停委买额前 N、竞价成交额前 N、9:25 尾秒抢筹、9:25 尾秒撤退、昨日炸板今表现、昨日涨停今表现；每行保留完整竞价字段。未传日期且今天非交易日时按交易日历查询上一交易日并标注实际日期；显式日期不自动换日。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `auction_theme_strength`: 默认按开盘啦题材聚合集合竞价表现，也可显式切到 CLS 概念或行业；输出竞价额、平均涨幅、高开数量、龙头候选和一致性；支持传 codes 只看自选股/观察池内部的主线强度。 何时使用: 题材集合竞价强度聚合：把全市场或自定义票池竞价数据按开盘啦题材/CLS 概念/行业聚合，默认开盘啦题材口径，回答"今天竞价资金打哪条主线"、"我的自选股里哪个方向最强"。未传日期且今天非交易日时按交易日历查询上一交易日并标注实际日期；显式日期不自动换日。
- `board_break_analysis`: 短线复盘核心面板：昨涨停 × 今日行情交叉。回答"昨涨停今天断板的、昨连板今天没板、高标杀、断板后是退潮还是分歧、晋级/淘汰率、市场是退潮还是修复"。返回 breakRate（断板率）、avgBrokenPctChg、sentimentSignal=cooling/neutral/warming、highBoardBroken 高标杀名单、statusBreakdown 细分。focus=broken/sealed_again/all。 何时使用: 断板分析（短线复盘核心面板）：昨涨停 × 今日行情交叉。短线高频问法直接命中："昨天涨停今天断板的有哪些"、"昨天连板今天没板的"、"高标(≥3 板)有没有被杀"、"断板后是直接低开退潮还是分歧高开低走"、"昨日连板淘汰率"、"今天市场是退潮还是修复"。返回 summary.breakRate（断板率）、avgBrokenPctChg（平均跌幅）、sentimentSignal=cooling/neutral/warming（直接给出退潮信号）、highBoardBroken（高标杀名单）、statusBreakdown（限跌/深跌/分歧失败/红盘弱续 细分）。focus=broken 默认（只看断板）；sealed_again（只看续板成功）；all（两者）。minStreak=3 只看高标；theme 按题材过滤。
- `briefings`: AI 生成的每日市场简报（早盘/午盘/收盘/晚间），快速了解当日要点 何时使用: AI 生成的每日早/午/收盘/晚盘简报。
- `broken_limit_up`: 实时获取当日曾触及涨停但未能封住的炸板股列表，含最高封单和开板次数 何时使用: 炸板池，判断市场分歧；配合 limit_stats。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `capital_flow`: 资金流向：个股/大盘/北向=东财日频四档；盘中个股主力用 intraday_main_flow；板块资金请优先 theme_intraday_capital（本工具 flowType=sector 仅兼容，东财板块传 sectorSource=dongfang） 何时使用: 资金流：个股/大盘/北向=东财日频四档。板块资金请直接用 theme_intraday_capital；本工具 flowType=sector 仅兼容（默认等同 theme_*，东财板块传 sectorSource=dongfang）。盘中个股主力用 intraday_main_flow。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `cls_news`: 实时电报快讯原文，支持按关键词、股票、消息级别、时间范围过滤。用于盘前消息面复盘、盘中利好利空跟踪、个股相关消息查证。 何时使用: 实时电报快讯：实时滚动的快讯原文，支持按关键词/股票/级别/时间过滤。短线盘前复盘、盘中消息面跟踪、个股利好利空查证的核心信息源。每条结果带 ref 字段（markdown 超链接格式），回答时直接将 ref 值嵌入正文作为可点击引用，不要另列 References 段落。
- `convertible_bond_market`: 查询可转债搜索、正股映射、实时快照、涨幅/成交额排行、日线、分钟线和转股溢价率。可转债是独立资产，不要当作股票涨停或股票筛选工具使用。 何时使用: 可转债行情工具：查转债搜索、正股映射、实时快照、涨幅/成交额排行、日线、分钟线和转股溢价率。不要把可转债当股票涨停工具使用。
- `dragon_tiger`: 龙虎榜买卖席位详情。按游资名/营业部追踪请用 branchSearch（不要用 stockName），如 branchSearch="炒股养家" 会通过 BranchTag 反查自动扩展到对应营业部；startDate+endDate 支持区间扫描（如某游资最近一周操作轨迹）；stockCode 查个股席位。 何时使用: 龙虎榜席位和机构/活跃资金。重要：「按游资名/营业部追踪」必须用 branchSearch 参数，不要用 stockName（stockName 只搜股票名）。例：查"炒股养家最近一周操作"用 branchSearch="炒股养家"+startDate/endDate（支持 BranchTag 标签反查，会自动扩展到对应营业部）；查"三亚迎宾路上榜没"用 branchSearch="三亚迎宾路"；查"某票谁在做"用 stockCode。配合 limit_up_ladder。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `etf_market`: 查询 ETF 搜索、实时快照、涨幅/成交额排行、日线和分钟线。ETF 是独立资产，不要把 ETF 条件查询改用 stock_screener。 何时使用: ETF 行情工具：查 ETF 搜索、实时快照、涨幅/成交额排行、日线和分钟线。不要把 ETF 塞进 stock_screener。
- `financial_summary`: 聚合利润表、资产负债表、现金流量表、财务指标、审计意见和主营构成，形成个股基本面摘要 何时使用: 营收/利润/现金流/ROE/审计/主营构成；纯短线问题不用。
- `index_market`: 查询指数搜索、实时快照、涨幅/成交额排行、日线和分钟线。实时快照、排行和当日分钟线读取站内持续落盘数据，不会因单次调用现场冷取；用于三大指数、宽基指数、行业指数点位和走势分析。两市成交额及量能变化直接读取 summary.marketTurnover 或 marketTurnoverSeries；市场宽度仍使用 market_overview。 何时使用: 指数行情工具：查三大指数/宽基/行业指数点位、涨跌幅、成交额排行、日线和分钟线。用户问"两市成交额/沪深成交额/全市场成交额/量能变化"时用 summary.marketTurnover 或 marketTurnoverSeries；不要自行混加不同 amountScope 的指数行，也不要用 market_overview 或 short_term_emotion 代替。
- `intraday_main_flow`: 查询盘中个股主力资金快照，支持自选股/指定代码池过滤。口径为开盘红盘中主力净额，不是传统四档大/中/小单资金流；用户问盘中主力、大单、竞价主力净额时优先使用。 何时使用: 盘中个股主力资金：开盘红口径，不是传统四档大/中/小单资金流。用户问自选股/指定股票盘中主力净额、大单净额、竞价主力净额时优先用它；不要改用 capital_flow。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `kline`: 获取个股日K线数据，盘中实时融合最新行情，支持自定义天数范围；adjust=qfq 可返回前复权价格，默认 none 不复权 何时使用: 日K线原子工具：返回指定股票或批量股票的 OHLC、涨跌幅、成交额 amount（元）、换手率等历史序列；适合计算区间涨幅、阶段高低点、价格分位、放量倍数等窗口型条件。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limit_down`: 实时获取当日跌停股池，含跌停原因、封单金额等，识别市场恐慌情绪 何时使用: 跌停池和负反馈分析。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limit_events`: 实时推送涨停封板和炸板事件，精确到秒级时间戳，适合盘中监控 何时使用: 秒级封/炸事件流。仅当用户明确要求实时事件或最新封板时使用，否则用 limit_up_ladder。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limit_event_summary`: 聚合封板/炸板事件流，提炼首封最早、炸板最多、回封最多、尾盘事件和分时情绪拐点 何时使用: 盘中分歧/炸板潮/尾盘事件/反复回封等过程分析；普通复盘不需要。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limit_stats`: 实时涨跌停统计：封板数、炸板数、封板率、今日vs昨日对比，量化市场强度 何时使用: 权威涨跌停/炸板/封板率口径；历史交易日优先读取本地收盘统计，盘前/非交易日返回明确状态。配合 market_overview 和 limit_up_ladder。
- `limit_up_filter`: 涨停事件池原子工具：按日期/区间筛选涨停记录，支持连板数、开盘啦主类题材、涨停原因、行业、流通市值/总市值、涨停日成交额、封单额、换手率、炸板次数、首封时间、回封标签等事件字段。返回记录可作为 kline、valuation_snapshot、stock_screener 等后续原子工具的候选池；给用户描述封板时间时优先使用 firstLimitUpTimeText/lastLimitUpTimeText。 何时使用: 涨停事件池原子工具：按日期/区间返回涨停记录，可筛连板数、题材/原因/行业、流通市值/总市值、涨停日成交额 trading_amount（元）、封单额、换手率、炸板次数、首封时间、回封标签。返回 rows 保留 date/code/name 及事件字段，适合作为后续 kline/valuation_snapshot/stock_screener 的候选池；给用户描述封板时间时优先读 firstLimitUpTimeText/lastLimitUpTimeText。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limit_up_ladder`: 实时按连板高度分层展示涨停股，清晰呈现当日连板梯队结构和晋级路径 何时使用: 涨停梯队、连板高度、龙头结构；返回 primaryThemeStats 表示按开盘啦主类聚合的涨停题材排行；配合 limit_stats、dragon_tiger。行内 firstLimitUpTime/lastLimitUpTime 是原始时间字段，给用户描述封板时间时优先读 firstLimitUpTimeText/lastLimitUpTimeText。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limit_up_premium`: 统计涨停股次日溢价收益排行，量化打板策略的盈亏比和成功率 何时使用: 涨停次日溢价和历史胜率统计；不能单独作实时信号。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `limitup_review_workflow`: 一键生成涨停板复盘数据包：涨跌停统计、涨停梯队、涨停主类排行、炸板池、跌停池，可选涨停溢价统计。 何时使用: 一键涨停复盘：涨跌停统计/梯队/题材/炸板/跌停。默认 digest。盘中事件分析问题再开 includeEventSummary。
- `macro_calendar`: 查询全球宏观财经日历，覆盖经济数据、央行/机构事件、国家/货币维度；适合回答未来几天有哪些重要经济数据或宏观事件。 何时使用: 宏观财经日历：查询未来/指定日期的全球经济数据和宏观事件，支持国家、货币、关键词过滤。适合"未来几天有哪些重要经济数据/央行事件"；不覆盖全部产业大会和产品发布。
- `margin_trading`: 查询融资融券市场汇总或个股明细。传 code 返回 margin_detail，不传 code 返回交易所汇总 margin；支持 tradeDate 或 startDate/endDate。 何时使用: 融资融券：不传 code 返回交易所汇总，传 code 返回个股融资融券明细。用于判断杠杆资金拥挤、融资余额变化和券源/融券压力。
- `market_catalyst_calendar`: 查询政策会议、行业大会、产品发布、指数调整、经济数据和假日等未来催化事件。适合回答"未来几天有什么短线催化/大会/发布会/政策生效"。 何时使用: 短线催化日历：查询政策会议、行业大会、产品发布、指数调整、重要经济数据和假日等未来催化事件。用户问"未来几天有什么短线催化/大会/发布会/政策生效/行业会议"时优先使用；不是上市公司公告原文。
- `market_overview`: 实时全市场涨跌家数、市场温度计等大盘宽度数据；涨跌停/炸板口径请使用 limit_stats 何时使用: 实时全市场涨跌家数、市场温度计等大盘宽度（开盘啦）。不传日期时，交易日默认今日，非交易日按交易日历自动取上一交易日并标注 fallback；交易日开市前若尚未就绪返回 MARKET_SUMMARY_NOT_READY，不冒充昨收。涨跌停/炸板口径请用 limit_stats。
- `market_replay_workflow`: 一键生成 A 股市场复盘数据包：交易日判断、市场概况、涨跌停统计、涨停梯队、涨停主类排行、概念排行和每日简报；股票/资讯热榜默认不跑，可按需开启。 何时使用: 一键 A 股复盘：温度/宽度/涨跌停/梯队/题材/简报。默认 digest。问题问到题材为什么热时再开 includeHotlist。
- `minute_data`: 获取个股实时或指定交易日分时走势，含价格、均价和成交量；历史日期优先读取单股归档 何时使用: 个股分时路径：盘中查实时走势；历史查询传 tradeDate，优先读取“单票+交易日”归档。
- `news_hotlist`: 聚合全网热点与财经媒体热榜，观察资讯关注度和潜在题材线索。 何时使用: 资讯热榜：全网/财经媒体热点话题排行；用于观察消息面温度和潜在题材线索。
- `northbound_holdings`: 查询沪深股通持股明细。传 code 返回个股北向持股历史，不传 code 可按日期查看全市场明细；marketType 可选 SH/SZ。 何时使用: 北向持股：沪深股通个股持股和全市场持股明细。用于判断外资持仓变化，注意数据通常下个交易日更新。
- `official_announcements`: 查询上市公司正式公告。默认读取站内记录；支持 keywords 多关键词一次检索并返回 matchedKeywords；verificationMode=live 较慢，仅用于用户明确要求官网实时核验；verificationMode=auto 会先查站内记录，缺失时再补查官网。 何时使用: 查上市公司正式公告。默认使用站内记录；支持 keywords 多关键词并行检索；只有用户明确要求官网实时核验/站内记录缺失补查时才切到实时或自动核验。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `official_disclosure_evidence`: 给定股票，聚合官方公告和官方互动问答，返回单股官方证据包。默认读站内记录；支持 keywords 多关键词证据包；verificationMode=auto 会先查站内记录，缺失时再补官网；verificationMode=live 较慢，仅用于明确要求。 何时使用: 给单股同时返回公告和官方互动问答证据包。默认使用站内官方证据；支持 keywords 多关键词证据包；自动核验会先查站内记录，缺失时再补官网。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `official_interactions`: 查询深交所互动易和上证 e 互动问董秘数据。默认读取站内记录；支持 keywords 多关键词一次检索并返回 matchedKeywords；verificationMode=live 较慢，仅用于用户明确要求官网实时核验；verificationMode=auto 会先查站内记录，缺失时再补查官网。 何时使用: 查官方互动问答（深交所互动易/上证 e 互动）。默认使用站内记录；支持 keywords 多关键词并行检索；只有用户明确要求官网实时核验/站内记录缺失补查时才切到实时或自动核验。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `research_reports`: 券商研报查询：个股评级、目标价、盈利预测，支持按股票或关键词搜索 何时使用: 券商研报和评级；配合 kline、capital_flow。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `sec_company_facts`: 查询 SEC companyfacts XBRL 财务事实，支持 Revenues、NetIncomeLoss、Assets、EarningsPerShareDiluted 等 us-gaap/dei tags。用于美股财报事实核验。 何时使用: SEC companyfacts：按 ticker/CIK 查询 XBRL 财务事实，如 Revenues、NetIncomeLoss、Assets、EarningsPerShareDiluted。适合美股财报事实核验。
- `sec_company_search`: 按美股 ticker 或公司名检索 SEC 公司 CIK。查询美国上市公司 10-K/10-Q/8-K/companyfacts 前先用它解析公司。 何时使用: SEC 公司检索：按美股 ticker/公司名查 CIK。用户问美股公告、10-K/10-Q/8-K、海外公司财报前先用它解析公司。
- `sec_filings`: 查询美国上市公司最近 SEC filings，支持 10-K、10-Q、8-K、DEF 14A、Form 4、13F-HR 等表单过滤，并返回 SEC 官方 filing URL。 何时使用: SEC filings 列表：按 ticker 或 CIK 查询 10-K/10-Q/8-K/DEF 14A/Form 4 等最近披露，并返回官方 filing URL。适合海外公司披露核验和 A 股海外映射。
- `sector_analysis`: 板块轮动四象限分析（动量 × 强度），默认开盘啦题材口径；也可切行业/财联社概念 何时使用: 板块轮动四象限，默认开盘啦题材口径（source=kpl）；行业用 source=industry；财联社概念兼容 source=cls_concept。配合 theme_intraday_capital / theme_stocks。
- `shareholder_structure`: 聚合十大股东、十大流通股东、股东户数、质押、分红和回购数据，观察筹码和公司行为 何时使用: 十大股东、户数趋势、质押、分红、回购；配合 valuation_snapshot。
- `short_term_emotion`: 查询早盘/盘中短线情绪快照，包含涨跌停、炸板率、晋级率、涨停委买额、一字封单额和市场宽度。用于快速判断短线情绪强弱。turnoverAmountYi 仅是情绪源附带成交额，不是交易所两市成交额；两市成交额请改用 index_market。 何时使用: 早盘/盘中短线情绪仪表盘：涨跌停、炸板率、晋级率、涨停委买额、一字封单、市场宽度。盘前数据未开始时返回 status=not_started 与 availableAfter，Agent 应按提示等待而不是循环重试。用户问"今天情绪怎么样/晋级率/封单/炸板率"时优先用它，再下钻 limit_stats/limit_up_ladder。turnoverAmountYi 不是交易所两市成交额；问两市/沪深成交额请改用 index_market。
- `smart_hotlist`: 股票热榜：platform 默认 combined 综合热榜；也支持 ths=同花顺、eastmoney=东方财富、tgb=淘股吧、kaipanla=开盘啦等单平台热股排行，返回会保留平台信息。 何时使用: 股票热榜：多平台热股关注度排行；不可用作基本面证据或直接因果证据。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `stock_event_calendar`: 聚合限售解禁、股东增减持、回购、分红除权和财报披露计划，用于短线排雷、事件驱动和盘前风险检查；不是宏观财经日历/产业大会日历。eventTypes 支持 unlock/holder_trade/repurchase/dividend/disclosure。 何时使用: 公司事件/风险日历：聚合限售解禁、股东增减持、回购、分红除权、财报披露计划。短线用途是排雷、解释事件驱动和盘前风险检查；不是宏观财经日历/产业大会日历。
- `stock_rank`: 实时涨幅榜、跌幅榜、成交额榜、换手率榜等多维排行，盘中实时刷新 何时使用: 全市场涨跌幅/成交金额/换手榜 + 盘中异动榜；参数用 type（或别名 rankType），支持 gainers/losers/amount 等，盘中异动用 speed_5m/speed_down_5m/amount_5m（5分钟涨速/跌速/成交额，分钟级更新）；changePercent/pctChange/涨幅榜会软映射到 gainers。返回 rows[] 附带前复权 change3d/change5d/change10d/change20d，普通多周期强弱比较不要重复调用多个 N 日榜；配合 theme_intraday_capital 找题材。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `stock_research_workflow`: 一键生成个股研究数据包：股票搜索、K 线、个股资金流、研报、龙虎榜，并可附带估值、财务摘要和股东结构。 何时使用: 一键个股研究：K 线/资金流/研报/龙虎榜，可选估值/财务/股东。默认 digest。短线场景可关 includeFundamental。
- `stock_screener`: MCP 主条件选股工具：支持概念/题材、行业、地区、股票名称包含、价格、市值、收盘涨跌幅、盘中最高/最低涨幅、开盘涨幅、换手、成交额、PE/PB、均线位置、放量倍数、市场板块和 ST/上市状态过滤。用户用问财式自然语言提条件时，agent 应直接映射为本工具结构化参数再调用。 何时使用: MCP 主条件选股工具。conceptKeywords/conceptCodes 默认开盘啦题材库（conceptSource=kpl）；未命中可设 conceptSource=auto 回退东财/CLS。用户用问财式自然语言提条件时，agent 应先把语义直接映射到本工具 schema 参数再调用，例如"半导体板块、五日线之上、放量三倍、上海、名字带龙"→conceptKeywords/aboveMa/volumeRatioMin/areaKeywords/nameIncludes；"收盘涨幅超过7"→closePctChgMin:7；"盘中最高涨幅超过7/最高到过7以上"→highPctChgMin:7。不要在 agent 侧分批拼 concept_stocks+kline+valuation_snapshot。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `stock_search`: 通过股票名称、代码、拼音或行业关键词模糊搜索，快速定位目标股票 何时使用: 模糊股票名/拼音/行业/代码解析；结果传给 kline/capital_flow/research_reports 等。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `theme_intraday_capital`: 题材/板块强度与主力资金主入口：默认返回最新快照；mode=timeline 可返回精选题材、概念或行业的盘中资金曲线。问爆发原因/为何走强时传 includeBoomReason=true 读 boomReason。成分股下钻请用 theme_stocks。 何时使用: 题材/板块主入口：盘中板块强度与主力资金排行。问"为什么这个板块强/爆发逻辑"时传 includeBoomReason=true 读取 rows[].boomReason（冷门板可能为空，勿编造）。成分下钻用 theme_stocks。不要用 capital_flow(sector) 或已隐藏的 concept_ranking。
- `theme_stocks`: 题材成分股主入口。传入 theme_intraday_capital 的 themeCode（如 801843k）或题材名；返回成分股代码、名称、热度与标签。 何时使用: 题材成分股主入口：传 theme_intraday_capital 的 themeCode（如 801843k）或题材名。不要用已隐藏的 concept_stocks。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `trading_calendar`: 查询指定日期是否为A股交易日，自动处理节假日和周末 何时使用: 周末/节假日前后判断今日是否交易日。
- `unlock_events`: 查询个股或全市场限售股解禁事件，返回解禁日期、解禁股份、解禁比例、股东和股份类型。适合排查未来解禁压力。 何时使用: 限售解禁专项：查全市场或单股未来/历史解禁压力。用户问"明天/下周哪些票解禁"或"这票有没有解禁压力"时使用。
- `valuation_snapshot`: 获取个股最新估值、市值、换手率、股息率等 daily_basic 指标，适合快速判断估值位置 何时使用: PE/PB/PS/股息率/市值快照；配合 financial_summary。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `watchlist_add`: 把用户明确指定的股票加入当前 API key 所属用户的私有自选股，支持批量、去重、自动分组、标签和备注。写入工具，仅在用户明确要求加入自选时使用。 何时使用: 把用户明确指定的一只或多只股票加入当前 API key 所属用户的自选股。自选总数最多 300 只，每组最多 50 只；同一股票可属于多个组。支持股票名称/代码混输、批量去重、自动分组（连板/首板/题材/行业）和备注标签。只有用户明确要求"加入自选/加到观察池/帮我收藏这些票"时调用。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `watchlist_group_create`: 创建当前 API key 所属用户的空自选股分组。写入工具，仅在用户明确要求新增/创建分组时使用。 何时使用: 创建当前 API key 所属用户的自选股空分组。自选分组最多 20 个。只有用户明确要求创建/新增分组时调用。
- `watchlist_group_delete`: 删除当前 API key 所属用户的自选股分组。股票仍保留在自选股中，只移出该组。写入工具，仅在用户明确要求删除/清理分组时使用。 何时使用: 删除当前 API key 所属用户的自选股分组。股票仍保留在自选股中，只移出该组。只有用户明确要求删除/清理分组时调用。
- `watchlist_group_list`: 读取当前 API key 所属用户的自选股分组列表，支持只看空分组。只读工具。 何时使用: 读取当前 API key 所属用户的自选股分组列表，可筛空分组。只在用户明确问"我的自选分组/有哪些空组/分组列表"时使用。
- `watchlist_group_rename`: 重命名当前 API key 所属用户的自选股分组，并同步更新该分组内股票。写入工具，仅在用户明确要求改分组名/重命名分组时使用。 何时使用: 重命名当前 API key 所属用户的自选股分组，并同步更新组内股票分组名。只有用户明确要求改分组名/重命名分组时调用。
- `watchlist_list`: 读取当前 API key 所属用户的私有自选股列表，返回分组、标签、备注和最近涨停上下文。只读工具。 何时使用: 读取当前 API key 所属用户的自选股列表，可按 groupName 筛选，并返回分组、标签、备注和最近涨停上下文。只在用户明确问"我的自选/自选股列表/观察池"时使用。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `watchlist_remove`: 从当前 API key 所属用户的私有自选股中移除用户明确指定的股票。写入工具，仅在用户明确要求删除/移除时使用。 何时使用: 从当前 API key 所属用户的自选股中移除股票。只有用户明确要求移除/删除自选时调用。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。
- `watchlist_update_stock`: 更新当前 API key 所属用户自选股条目的分组、标签、备注或来源上下文。写入工具，仅在用户明确要求移动股票分组、打标签或改备注时使用。 何时使用: 更新当前 API key 所属用户自选股条目的分组、标签、备注。groupMode=add 可把股票追加到新分组且保留原分组；replace 才是移动到新分组。适合用户说"把这些票移到某组/打标签/改备注"。 【链接】rows/items/嵌套股票对象含 code/name；列股必须用 `[name(code)](https://stock.quicktiny.cn/quote/<code>)` markdown 链接。