接口文档
工具、参数与返回结构
这里记录当前 MCP tools/list 暴露的 23 个工具:工具名、描述、参数、示例参数和返回说明。 其中 22 个业务工具支持 HTTP API 备用调用,连接测试工具仅用于 MCP 连通性验证。
以 MCP tools/list 当前暴露内容为准。
业务工具可用同一参数结构调用 HTTP API。
用于验证 MCP 端点与 Token 配置。
23 个工具参数
MCP 调用时把下列参数放入 params.arguments;支持 HTTP API 的工具使用同样的 { arguments: { ... } } 请求体。 结构化业务工具的 MCP 响应会同时在 content[].text 和 structuredContent 中提供完整 JSON 结果。
search_code代码搜索MCP / HTTP API通过关键词搜索股票、指数和宏观指标代码。
查看详情
search_code代码搜索MCP / HTTP API通过关键词搜索股票、指数和宏观指标代码。
先用名称、简称或代码片段确认标准 ticker,再传给行情、估值、财务或宏观接口。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 搜索关键词,例如 "平安"、"000001"。 |
| data_type | string | 否 | - | 数据类型过滤,可选 "A股"、"美股"、"港股"、"指数"、"宏观指标"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result[] | object[] | 匹配到的代码候选列表。 |
| result[].code / ticker | string | 可继续传给行情、估值、财务或宏观工具的标准代码。 |
| result[].name | string | 证券、指数或宏观指标名称。 |
| result[].data_type | string | 候选结果所属类型,例如 A股、美股、港股、指数或宏观指标。 |
返回候选标的代码、名称、市场类型,以及宏观指标的单位、来源和样本覆盖信息。
{
"arguments": {
"keyword": "平安",
"data_type": "A股"
}
}{
"tool": "search_code",
"arguments": {
"keyword": "平安",
"data_type": "A股"
},
"result": [
{
"ticker": "000001.SZ",
"name": "平安银行",
"data_type": "A股"
}
]
}get_basicinfo基础信息MCP / HTTP API根据 A股 TRADE_CODE 查询公司基础信息。
查看详情
get_basicinfo基础信息MCP / HTTP API根据 A股 TRADE_CODE 查询公司基础信息。
已知 A股代码时,用于读取公司名称、上市日期、地域、行业分类、主营业务和主要股东信息。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| TRADE_CODE | string | 是 | - | A股股票代码,例如 "000001.SZ"、"600519.SH"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的公司基础信息,表头直接使用 db_schema.json 对应列 comment,例如 股票代码、股票名称、上市日期、申万一级行业、业务范围、大股东名称、大股东持股比例、更新日期;metadata 保留内部字段名和原始数据库列名。
{
"arguments": {
"TRADE_CODE": "600519.SH"
}
}{
"tool": "get_basicinfo",
"arguments": {
"TRADE_CODE": "600519.SH"
},
"result": {
"message": "返回 compact_table 结构的公司基础信息,表头直接使用 db_schema.json 对应列 comment,例如 股票代码、股票名称、上市日期、申万一级行业、业务范围、大股东名称、大股东持股比例、更新日期;metadata 保留内部字段名和原始数据库列名。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_stock_market_history行情MCP / HTTP API获取股票或指数历史行情数据。
查看详情
get_stock_market_history行情MCP / HTTP API获取股票或指数历史行情数据。
按 ticker 和日期区间返回开高低收、成交量、成交额,以及当前真实表中可用的扩展字段。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 证券代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| data_type | string | 否 | - | 数据类型,可选 "A股"、"美股"、"港股"、"指数"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的历史行情行,列随市场和底层数据表可用字段变化。
{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股"
}
}{
"tool": "get_stock_market_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股"
},
"result": {
"message": "返回 compact_table 结构的历史行情行,列随市场和底层数据表可用字段变化。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_stock_valuation_history估值MCP / HTTP API获取股票或指数历史估值数据。
查看详情
get_stock_valuation_history估值MCP / HTTP API获取股票或指数历史估值数据。
用于查询 PE、PB、PS、分位数、股息率等当前数据源实际存在的估值字段。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 证券代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| data_type | string | 否 | - | 数据类型,可选 "A股"、"美股"、"港股"、"指数"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的估值历史行,只包含当前数据源可用字段。
{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股"
}
}{
"tool": "get_stock_valuation_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股"
},
"result": {
"message": "返回 compact_table 结构的估值历史行,只包含当前数据源可用字段。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_index_components指数MCP / HTTP API通过指数代码获取指数成份股。
查看详情
get_index_components指数MCP / HTTP API通过指数代码获取指数成份股。
输入指数代码,返回当前可用的成份股列表、权重和成份日期。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| index_code | string | 是 | - | 指数代码,例如 "000300.SH"、"000905.SH"、"399001.SZ"。 |
| as_of_date | string | 否 | - | 查询日期,格式 YYYY-MM-DD;不传默认为当前日期。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table 结构的成份股列表,字段包含 trade_code、weight、component_date。
{
"arguments": {
"index_code": "000300.SH",
"as_of_date": "2026-05-28"
}
}{
"tool": "get_index_components",
"arguments": {
"index_code": "000300.SH",
"as_of_date": "2026-05-28"
},
"result": {
"message": "返回 compact_table 结构的成份股列表,字段包含 trade_code、weight、component_date。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_macro_data宏观MCP / HTTP API获取宏观指标历史数据。
查看详情
get_macro_data宏观MCP / HTTP API获取宏观指标历史数据。
先用 search_code 查找宏观指标代码,再按日期区间拉取历史观测值。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 宏观指标代码,例如 "M0001385"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回观测日期、数值,并附带单位、来源、最新观测日和样本覆盖范围等元数据。
{
"arguments": {
"ticker": "M0001385",
"start_date": "2020-01-01",
"end_date": "2024-12-31"
}
}{
"tool": "get_macro_data",
"arguments": {
"ticker": "M0001385",
"start_date": "2020-01-01",
"end_date": "2024-12-31"
},
"result": {
"message": "返回观测日期、数值,并附带单位、来源、最新观测日和样本覆盖范围等元数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_financial_data财务MCP / HTTP API获取股票财务报表与核心财务字段。
查看详情
get_financial_data财务MCP / HTTP API获取股票财务报表与核心财务字段。
支持按报告日期、财年、年报口径过滤,也可请求白名单扩展字段。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| periods | integer | 否 | 8 | 返回期数,范围 1-500。 |
| data_type | string | 否 | all | "all"、"balance_sheet"、"income_statement"、"cash_flow"、"key_metrics"。 |
| market_type | string | 否 | - | 市场类型,可选 "A股"、"美股"、"港股"。 |
| start_date | string | 否 | - | 按报告日期 DT 过滤的开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 按报告日期 DT 过滤的结束日期,格式 YYYY-MM-DD。 |
| fiscal_year | integer | 否 | - | 指定单个财年,按 DT 年份过滤。 |
| start_year | integer | 否 | - | 起始财年,按 DT 年份过滤。 |
| end_year | integer | 否 | - | 结束财年,按 DT 年份过滤。 |
| annual_only | boolean | 否 | false | 是否只返回年报日期 12-31。 |
| extra_fields | string | 否 | - | 额外字段白名单,当前支持 "holder_pct_by_fund"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回财务结果集,包含报告日期、字段值和对应口径。
{
"arguments": {
"ticker": "000001.SZ",
"data_type": "income_statement",
"periods": 8,
"annual_only": true
}
}{
"tool": "get_financial_data",
"arguments": {
"ticker": "000001.SZ",
"data_type": "income_statement",
"periods": 8,
"annual_only": true
},
"result": {
"message": "返回财务结果集,包含报告日期、字段值和对应口径。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_stock_forecast_history预测MCP / HTTP API获取 A股股票一致预期历史。
查看详情
get_stock_forecast_history预测MCP / HTTP API获取 A股股票一致预期历史。
查询 FY1/FY2 收入、利润,以及同日可用的分歧度字段。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | A股股票代码,例如 "000001.SZ"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| limit | integer | 否 | 120 | 返回行数上限,范围 1-1000。 |
| market_type | string | 否 | - | 市场类型;当前仅支持 "A股"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回预测历史行;没有同日分歧度记录时不返回对应 std 字段。
{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"limit": 120
}
}{
"tool": "get_stock_forecast_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"limit": 120
},
"result": {
"message": "返回预测历史行;没有同日分歧度记录时不返回对应 std 字段。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_financial_ratios财务MCP / HTTP API计算并获取核心财务比率。
查看详情
get_financial_ratios财务MCP / HTTP API计算并获取核心财务比率。
查询 ROE、ROA、毛利率、净利率、资产负债率等指标。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| periods | integer | 否 | 4 | 返回期数,范围 1-40。 |
| market_type | string | 否 | - | 市场类型,可选 "A股"、"美股"、"港股"。 |
| end_date | string | 否 | - | 锚点日期,格式 YYYY-MM-DD;返回不晚于该日期的最近 periods 期。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回按报告期排列的财务比率数据。
{
"arguments": {
"ticker": "000001.SZ",
"periods": 4,
"market_type": "A股"
}
}{
"tool": "get_financial_ratios",
"arguments": {
"ticker": "000001.SZ",
"periods": 4,
"market_type": "A股"
},
"result": {
"message": "返回按报告期排列的财务比率数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_financial_growth财务MCP / HTTP API获取财务指标增长率。
查看详情
get_financial_growth财务MCP / HTTP API获取财务指标增长率。
用于追踪营收、净利润、总资产、权益等增长趋势。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | 股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。 |
| periods | integer | 否 | 8 | 返回期数,范围 1-40。 |
| market_type | string | 否 | - | 市场类型,可选 "A股"、"美股"、"港股"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回按报告期排列的增长率数据。
{
"arguments": {
"ticker": "000001.SZ",
"periods": 8,
"market_type": "A股"
}
}{
"tool": "get_financial_growth",
"arguments": {
"ticker": "000001.SZ",
"periods": 8,
"market_type": "A股"
},
"result": {
"message": "返回按报告期排列的增长率数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}screen_stocks选股MCP / HTTP APIA股多指标组合选股。
查看详情
screen_stocks选股MCP / HTTP APIA股多指标组合选股。
传入行业、指标列表、上下限和时间位移,筛选满足条件的股票。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| industry | string | 是 | - | 申万一级行业名称,例如 "电子";传 "全部" 表示全市场。 |
| ind_list | string[] | 是 | - | 指标名称列表,例如 ["roe", "net_profit_yoy"]。 |
| lower_list | number[] | 是 | - | 每个指标下限,与 ind_list 一一对应。 |
| upper_list | number[] | 是 | - | 每个指标上限,与 ind_list 一一对应。 |
| time_zone_list | integer[] | 是 | - | 每个指标的时间位移;0 表示当前,N 表示未来 N 年。 |
| limit | integer | 否 | 50 | 返回记录数上限,范围 1-500。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回满足条件的 A股标的和指标值。
{
"arguments": {
"industry": "全部",
"ind_list": [
"roe",
"net_profit_yoy"
],
"lower_list": [
10,
20
],
"upper_list": [
100,
200
],
"time_zone_list": [
0,
0
],
"limit": 50
}
}{
"tool": "screen_stocks",
"arguments": {
"industry": "全部",
"ind_list": [
"roe",
"net_profit_yoy"
],
"lower_list": [
10,
20
],
"upper_list": [
100,
200
],
"time_zone_list": [
0,
0
],
"limit": 50
},
"result": {
"message": "返回满足条件的 A股标的和指标值。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}list_indicators选股MCP / HTTP API列出 screen_stocks 可用指标。
查看详情
list_indicators选股MCP / HTTP API列出 screen_stocks 可用指标。
构造 screen_stocks 条件前,先查看可用指标名称和解释。
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result | string | 文本结果,包含检索摘要、匹配片段、指标说明或策略分析。 |
返回可用于多指标选股的指标名称和说明。
{
"arguments": {}
}{
"tool": "list_indicators",
"arguments": {},
"result": "返回文本摘要、匹配片段或指标说明。"
}get_stock_excess_return收益MCP / HTTP API计算 A股个股相对申万行业指数的超额收益。
查看详情
get_stock_excess_return收益MCP / HTTP API计算 A股个股相对申万行业指数的超额收益。
用于观察个股相对行业基准在一段时间内的收益表现。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| ticker | string | 是 | - | A股股票代码,例如 "000001.SZ"。 |
| date_benchmark | string | 是 | - | 基准日期,格式 YYYY-MM-DD。 |
| days | integer | 否 | 250 | 统计天数,范围 1-1000。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回个股收益、行业基准收益和超额收益。
{
"arguments": {
"ticker": "000001.SZ",
"date_benchmark": "2024-01-01",
"days": 250
}
}{
"tool": "get_stock_excess_return",
"arguments": {
"ticker": "000001.SZ",
"date_benchmark": "2024-01-01",
"days": 250
},
"result": {
"message": "返回个股收益、行业基准收益和超额收益。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_us_transcript文本检索MCP / HTTP API搜索美股公司财报会议纪要。
查看详情
search_us_transcript文本检索MCP / HTTP API搜索美股公司财报会议纪要。
用公司名称、股票代码或问题关键词检索电话会和管理层问答。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 搜索关键词,例如 "Apple"、"AAPL"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-100。 |
| content_mode | string | 否 | matched | 内容返回模式:matched 返回最相关的匹配内容;full 返回完整纪要正文。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供纪要标识、ticker、公司、文件、日期、相关度和内容;默认内容为最相关的匹配内容,content_mode=full 时为完整纪要正文。
{
"arguments": {
"keyword": "AAPL guidance",
"limit": 10,
"content_mode": "matched"
}
}{
"tool": "search_us_transcript",
"arguments": {
"keyword": "AAPL guidance",
"limit": 10,
"content_mode": "matched"
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供纪要标识、ticker、公司、文件、日期、相关度和内容;默认内容为最相关的匹配内容,content_mode=full 时为完整纪要正文。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_cn_transcript文本检索MCP / HTTP API语义搜索 A股公司调研纪要。
查看详情
search_cn_transcript文本检索MCP / HTTP API语义搜索 A股公司调研纪要。
按问题、公司名或股票代码检索投资者关系活动记录。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 语义搜索关键词,例如 "毛利率下降原因"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-50。 |
| company_name | string | 否 | - | 按公司名称过滤,例如 "宁德"。 |
| stock_code | string | 否 | - | 按股票代码精确过滤,例如 "300750"。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD;传入后按 create_date 硬过滤并关闭时间衰减。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD;传入后按 create_date 硬过滤并关闭时间衰减。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供股票代码、公司、标题、会议时间、发布时间、相关度和调研内容正文;未传日期范围时使用时间衰减排序。
{
"arguments": {
"keyword": "毛利率下降原因",
"company_name": "宁德",
"start_date": "2022-02-15",
"end_date": "2022-10-13",
"limit": 10
}
}{
"tool": "search_cn_transcript",
"arguments": {
"keyword": "毛利率下降原因",
"company_name": "宁德",
"start_date": "2022-02-15",
"end_date": "2022-10-13",
"limit": 10
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供股票代码、公司、标题、会议时间、发布时间、相关度和调研内容正文;未传日期范围时使用时间衰减排序。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_chart文本检索MCP / HTTP API搜索图表。
查看详情
search_chart文本检索MCP / HTTP API搜索图表。
用宏观、行业或指标关键词查找可用图表;拿到图表 ID 后可继续查看 chart_settings 并获取真实图表数据。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| keyword | string | 是 | - | 搜索关键词,例如 "GDP增速"、"居民消费"。 |
| limit | integer | 否 | 10 | 返回结果数量,范围 1-100。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供图表 ID、标题和相关度。
{
"arguments": {
"keyword": "GDP增速",
"limit": 10
}
}{
"tool": "search_chart",
"arguments": {
"keyword": "GDP增速",
"limit": 10
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供图表 ID、标题和相关度。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_chart_settings文本检索MCP / HTTP API获取 chart_settings(图表渲染参数定义)。
查看详情
get_chart_settings文本检索MCP / HTTP API获取 chart_settings(图表渲染参数定义)。
已知图表 ID 时,先读取 chart_settings。它不是图表数据,而是可传给 get_chart_data.selection_values 的 varname、默认值、候选项和日期约束。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| chart_id | integer | 是 | - | 图表 ID,例如 9258;可先用 search_chart 查找。 |
| include_dynamic_options | boolean | 否 | true | 是否展开 tmpl 类型 chart_settings 的动态候选值。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 compact_table chart_settings 表,并在顶层 resolved_setting 给出默认选择值。
{
"arguments": {
"chart_id": 9258,
"include_dynamic_options": true
}
}{
"tool": "get_chart_settings",
"arguments": {
"chart_id": 9258,
"include_dynamic_options": true
},
"result": {
"message": "返回 compact_table chart_settings 表,并在顶层 resolved_setting 给出默认选择值。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_chart_data文本检索MCP / HTTP API按 chart_settings 选择值获取图表数据。
查看详情
get_chart_data文本检索MCP / HTTP API按 chart_settings 选择值获取图表数据。
用 get_chart_settings 确认 chart_settings.varname 后,传入 selection_values 获取对应真实渲染数据。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| chart_id | integer | 是 | - | 图表 ID,例如 9258;可先用 search_chart 查找。 |
| selection_values | object | 否 | - | 选择值,键为 chart_settings.varname,会覆盖默认值。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 resolved_setting 和 compact_table 数据集。
{
"arguments": {
"chart_id": 9258,
"selection_values": {
"industry": "消费"
}
}
}{
"tool": "get_chart_data",
"arguments": {
"chart_id": 9258,
"selection_values": {
"industry": "消费"
}
},
"result": {
"message": "返回 resolved_setting 和 compact_table 数据集。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}search_news文本检索MCP / HTTP API搜索财经新闻资讯。
查看详情
search_news文本检索MCP / HTTP API搜索财经新闻资讯。
用自然语言问题或关键词检索当前财经新闻;服务端固定使用财经主题。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| query | string | 是 | - | 财经新闻搜索问题或关键词,例如 "AI earnings"、"美联储 降息"。 |
| max_results | integer | 否 | 5 | 返回结果数量,范围 1-20。 |
| time_range | string | 否 | - | 按发布或更新时间过滤,可选 day/week/month/year 或 d/w/m/y。 |
| start_date | string | 否 | - | 开始日期,格式 YYYY-MM-DD。 |
| end_date | string | 否 | - | 结束日期,格式 YYYY-MM-DD。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回文本摘要,并在结构化结果中提供标题、URL、相关度、内容片段和 favicon;metadata 包含请求 ID、响应耗时和用量信息。
{
"arguments": {
"query": "AI earnings",
"max_results": 5,
"time_range": "week"
}
}{
"tool": "search_news",
"arguments": {
"query": "AI earnings",
"max_results": 5,
"time_range": "week"
},
"result": {
"message": "返回文本摘要,并在结构化结果中提供标题、URL、相关度、内容片段和 favicon;metadata 包含请求 ID、响应耗时和用量信息。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_data语义查询MCP / HTTP API自然语言金融数据查询工具。
查看详情
get_data语义查询MCP / HTTP API自然语言金融数据查询工具。
直接描述想要的数据,适合探索式查询或跨表组合查询。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| query | string | 是 | - | 自然语言查询,例如 "获取茅台的行情数据和财务数据"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result.message | string | 本次工具调用的结果摘要。 |
| result.data[] | object[] | 一个或多个结构化结果集。 |
| result.data[].format | string | 结果集格式;表格结果通常为 "compact_table"。 |
| result.data[].columns | string[] | 表格列名,按 rows 中每行的值顺序排列。 |
| result.data[].rows | array[] | 二维数组形式的数据行,避免每行重复字段名。 |
| result.credits | string | 额度计算说明;实际扣费以调用日志记录为准。 |
返回 message 加 data 的结构化结果,通常使用 compact_table 表示表格数据。
{
"arguments": {
"query": "获取茅台近一个月行情和最近四期财务数据"
}
}{
"tool": "get_data",
"arguments": {
"query": "获取茅台近一个月行情和最近四期财务数据"
},
"result": {
"message": "返回 message 加 data 的结构化结果,通常使用 compact_table 表示表格数据。",
"data": [
{
"format": "compact_table",
"columns": [
"date",
"value"
],
"rows": [
[
"2024-01-02",
1.23
]
]
}
],
"credits": "按实际返回量计算"
}
}get_research语义查询MCP / HTTP API非结构化投资研究和观点检索。
查看详情
get_research语义查询MCP / HTTP API非结构化投资研究和观点检索。
描述研究问题,返回匹配研究材料和观点线索。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| query | string | 是 | - | 自然语言研究查询,描述你想了解的内容。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result | string | 文本结果,包含检索摘要、匹配片段、指标说明或策略分析。 |
返回研究摘要、来源材料和可追溯内容片段。
{
"arguments": {
"query": "近期消费电子行业景气度有哪些变化"
}
}{
"tool": "get_research",
"arguments": {
"query": "近期消费电子行业景气度有哪些变化"
},
"result": "返回文本摘要、匹配片段或指标说明。"
}get_strategy语义查询MCP / HTTP APIA股多指标组合选股与历史超额收益回测。
查看详情
get_strategy语义查询MCP / HTTP APIA股多指标组合选股与历史超额收益回测。
用自然语言描述选股策略,由系统转成指标条件并给出筛选和回测结果。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| strategy_description | string | 是 | - | 自然语言描述选股策略,包括行业、指标条件和目标。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| tool | string | 本次调用的工具名。 |
| arguments | object | 服务端校验后实际执行的参数。 |
| result | string | 文本结果,包含检索摘要、匹配片段、指标说明或策略分析。 |
返回策略解析、候选股票和历史超额收益结果。
{
"arguments": {
"strategy_description": "在电子行业中筛选 ROE 高于 10 且净利润增速高于 20 的股票"
}
}{
"tool": "get_strategy",
"arguments": {
"strategy_description": "在电子行业中筛选 ROE 高于 10 且净利润增速高于 20 的股票"
},
"result": "返回文本摘要、匹配片段或指标说明。"
}greet连接测试仅 MCP打招呼工具,用于测试 MCP 服务器连接和鉴权是否成功。
查看详情
greet连接测试仅 MCP打招呼工具,用于测试 MCP 服务器连接和鉴权是否成功。
完成 MCP 端点和 Bearer Token 配置后,可用这个工具做最小化连通性检查;该工具仅通过 MCP tools/list 与 tools/call 暴露。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| name | string | 是 | - | 要打招呼的名称,例如 "World"。 |
| 返回字段 | 类型 | 说明 |
|---|---|---|
| content[].type | string | MCP 内容类型,文本结果为 "text"。 |
| content[].text | string | 工具返回的文本内容;结构化业务工具会在这里放入完整 JSON 结果。 |
返回纯文本问候语,例如 "Hello, World!"。
{
"arguments": {
"name": "World"
}
}{
"content": [
{
"type": "text",
"text": "Hello, World!"
}
]
}调用入口与示例
下面只保留必要的调用地址和请求结构;客户端配置、Token 创建和排障流程请查看接入指南。
https://vmcp.hzinsights.com/HTTP API 和公开资源的生产基准地址。
https://vmcp.hzinsights.com/mcp/MCP 客户端配置地址,使用 tools/list 与 tools/call。
https://vmcp.hzinsights.com/api/v1/toolsHTTP API 方式列出工具名、描述和 input_schema。
https://vmcp.hzinsights.com/api/v1/tools/{tool_name}/callHTTP API 请求体固定为 { arguments: { ... } }。
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_stock_market_history",
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股"
}
}
}curl -X POST https://vmcp.hzinsights.com/api/v1/tools/get_stock_market_history/call \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <USER_TOKEN>" \
-d '{
"arguments": {
"ticker": "000001.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"data_type": "A股"
}
}'{
"message": "返回 market_history 结果集",
"data": [{
"format": "compact_table",
"columns": ["date", "open", "high", "low", "close"],
"rows": [["2024-01-02", 9.20, 9.35, 9.12, 9.28]]
}],
"credits": "按实际返回量计算"
}