MCP 可用工具

以下工具由 MCP 服务暴露，均符合 OpenAI Function 调用规范。客户端可通过 /mcp/tools 拉取元数据，通过 /mcp/call 发起调用。当前共暴露 38 个只读工具，覆盖指数 / 个股（A股+美股+港股）/ETF / 市场板块 / 恐惧贪婪 / 交易日历 / 财经新闻，与官网公开数据 API 一一对应。鉴权类、支付类与写数据类接口不在 MCP 工具范围内。

工具清单

股票列表 / 详情

工具名说明参数（* 为必填）

get_stock_list获取 A 股股票列表，支持按代码/名称关键词与交易所筛选。返回 [{symbol, name, market}]。q、exchange、page_size

get_stock_detail获取 A 股个股详情：基础信息 + 公司简介（profile）合并返回。symbol*

get_stock_info获取 A 股个股基本信息（含流通/总股本等），并把 FloatVolume/TotalVolume 提升为顶层字段。symbol*

get_stock_profile获取 A 股公司简介信息。symbol*

get_us_stock获取美股基本信息与公司简介（profile）。symbol*

get_hk_stock获取港股基本信息与公司简介（profile）。symbol*

历史行情

工具名说明参数（* 为必填）

get_stock_history获取 A 股个股历史日线（默认近一年/当日，按日期升序）。日线取自本地库，其它周期按需实时取数。symbol*、start_date、end_date、period

get_etf_history获取 A 股 ETF 历史日线（默认近一年/当日，按日期升序）。symbol*、start_date、end_date、period

get_us_stock_history获取美股历史 K 线（默认近一年/当日，按日期升序）。symbol*、start_date、end_date、period

get_hk_stock_history获取港股历史 K 线（默认近一年/当日，按日期升序）。symbol*、start_date、end_date、period

get_index_history获取指数历史日线（默认近一年/当日，按日期升序）。index_code 用裸码，如 000001（上证综指）、000300（沪深300）。index_code*、start_date、end_date

指数

工具名说明参数（* 为必填）

get_index_list分页读取平台指数清单（约 10604 只，覆盖 SSE/SZSE/CSI/SW）。支持 market/category/keyword 过滤。market、category、keyword、page、page_size

get_index_search按关键词搜索指数，按匹配相关度排序（适合输入框实时联想）。keyword 必填。keyword*、limit、market

get_index_constituents查询指定指数的最新成分股及权重（按权重降序）。index_code 用裸码或全码均可，默认 000300（沪深300）。index_code、page、page_size

ETF

工具名说明参数（* 为必填）

get_etf_list获取全市场 ETF 列表，每条含 symbol 与 name。支持关键词与交易所过滤。q、exchange

get_etf_info获取单只 ETF 的基本档案：名称、交易所、单位净值、申赎单位、ETF 类型、申赎开关等（不含成分明细）。symbol*

get_etf_pcf获取 ETF 最新交易日申赎清单（PCF）及成分明细（已剔除体积较大的 instrument_info 字段）。symbol*

get_etf_composition获取 ETF 最新交易日的成分股（仅含 component_name 与 component_code）。symbol*

市场 / 板块

工具名说明参数（* 为必填）

get_fear_greed查询指定指数在日期区间内的恐惧与贪婪指数，按交易日升序返回。index_code 为裸 6 位码，如 000001。index_code、start_date、end_date

get_sw_sector_change读取指定申万行业级别最新统计日的板块涨跌幅，按涨跌幅降序，含领涨领跌个股。sector_type 仅支持 sw1/sw2/sw3。sector_type*

get_sw_sector_catalog读取申万行业板块清单（板块代码与行业名称），由定时任务每周同步。sector_type 仅支持 sw1/sw2/sw3。sector_type*

交易日历 / Tick

工具名说明参数（* 为必填）

get_trading_calendar查询指定市场的交易日列表（ISO 日期字符串数组，升序）。可用 start_date/end_date 限定区间或 year 取某年；区间为空返回该市场全部已入库交易日。market、start_date、end_date、year

财务

工具名说明参数（* 为必填）

get_financial_data根据个股代码获取财务数据（按公告日期倒序）。report_type 可选 Balance/Income/CashFlow/PershareIndex。symbol*、start_date、end_date、report_type

上市公司公告

工具名说明参数（* 为必填）

get_stock_announcements按证券代码查询 A 股上市公司公告列表，可叠加标题关键词、日期区间与分类筛选。每条含标题、公告日期、分类，以及公告原文 PDF 直链与文件大小（只提供原文链接，不代为解析 PDF 正文）。stock*、keyword、start_date、end_date、category、page、page_size

财经新闻

工具名说明参数（* 为必填）

get_news_sources返回库中真实存在的财经快讯来源取值，供拼接 source 参数使用。无

get_news_flash按来源查询滚动财经快讯（对外公开接口），每条含摘要、标签、市场关联度、利好程度、关联个股与原文链接。分页信息在返回体的 total/page/page_size/has_more。source*、start_date、end_date、min_relation_level、page、page_size

get_market_news市场新闻分页查询（内部接口），支持来源、关键词、类型、关联股票、时间范围与关联度筛选。返回 {items,total,page,page_size,has_more}。sources、keyword、news_type、stock_code、start_time、end_time、relation_level、min_relation_level、page、page_size

get_market_news_detail按 ID 获取单条市场新闻详情。news_id*

其它

工具名说明参数（* 为必填）

get_us_stock_list获取美股股票列表，分页返回，按代码稳定排序。返回 {items, total, page, page_size, has_more}。q、exchange、page、page_size

get_hk_stock_list获取港股股票列表，分页返回，按代码稳定排序。返回 {items, total, page, page_size, has_more}。q、exchange、page、page_size

get_us_index_history获取美股指数历史行情，支持日线/周线/月线。index_code 可用清单代码（I:SPX）或简称（GSPC）。当前可查：GSPC标普500、NDX纳斯达克100、IXIC纳斯达克综合、DJI道琼斯工业、NYA纽交所综合、XAX美国交易所综合、SP400标普中盘400、SPXTR标普500全收益、OEX标普100、VIX波动率、DJT道琼斯运输。返回带 data_scope：local 为已同步入库的历史数据（附 coverage 说明实际覆盖的起止交易日与是否盖满请求区间），realtime 为本次实时取到的最新数据。index_code*、start_date、end_date、period

get_us_index_list分页读取美股指数清单，每日自动同步。每条含 symbol、name、quote_ready（行情是否可取）、quote_symbol（行情查询代码）。注意清单收录≠行情可取，可用 quote_ready_only 只筛出行情可查的指数。q、category、quote_ready_only、page、page_size

get_us_index_search按关键词搜索美股指数，按匹配相关度排序（适合输入框实时联想）。同时匹配清单代码、简称与名称。keyword 必填。keyword*、limit、category、quote_ready_only

get_macro_indicators列出已接入的宏观经济指标元信息：指标代码、国家/地区、频率、单位、最新数据日期与最新值。用于确认可查询的指标代码（如 CN_CPI_YOY、CN_M2_YOY）。无

get_macro_indicator按指标代码查询宏观经济时间序列（按数据日期升序）。支持中国 CPI 同比/环比/累计、PPI 同比/累计、制造业/非制造业 PMI、GDP 及同比、货币供应 M0/M1/M2 及 M2 同比、外汇储备等。日期留空表示不限制该端。indicator_code*、start_date、end_date

get_stock_factor_catalog列出个股技术因子库支持的全部因子（动量 / 波动率 / 乖离率 / RSI / MACD / 52 周区间 / 多头排列 / 收盘强度 / ATR）。每项含名称、含义、公式与用法，作为 factor_name 的取值字典。无

get_stock_factor_snapshot取某因子在某交易日的全市场截面（按代码升序分页），用于横向比较全市场某因子的分布或筛选。factor_name 必填；trade_date 留空时取该因子最新交易日。factor_name*、trade_date、page、page_size

get_stock_factor_latest取单只个股当前全部因子的最新值（每个因子对应其各自最新交易日），用于个股技术面快速体检。symbol 必填，裸码（如 600519）。symbol*

调用示例

cURL

curl -X POST "/mcp/call" \
  -H "Content-Type: application/json" \
  -d '{"function_name": "get_stock_list", "parameters": {"page_size": 10}}'

说明

MCP 接口不出现在 REST 的 OpenAPI 文档里，仅供 MCP 客户端调用。
工具返回结构与对应的 REST 接口一致，可直接对照接口页理解字段含义。
工具清单以本页为准；表中「参数」标注的必填项与服务端调用校验一致。