接口文档

工具、参数与返回结构

这里记录当前 MCP tools/list 暴露的 23 个工具:工具名、描述、参数、示例参数和返回说明。 其中 22 个业务工具支持 HTTP API 备用调用,连接测试工具仅用于 MCP 连通性验证。

需要配置客户端?

接入步骤、Token 获取和 MCP 客户端配置统一放在接入指南。

跳转到接入指南
MCP 工具
23 个

以 MCP tools/list 当前暴露内容为准。

HTTP 备用调用
22 个

业务工具可用同一参数结构调用 HTTP API。

连接测试
1 个

用于验证 MCP 端点与 Token 配置。

23 个工具参数

MCP 调用时把下列参数放入 params.arguments;支持 HTTP API 的工具使用同样的 { arguments: { ... } } 请求体。 结构化业务工具的 MCP 响应会同时在 content[].textstructuredContent 中提供完整 JSON 结果。

23 个工具
search_code代码搜索MCP / HTTP API

通过关键词搜索股票、指数和宏观指标代码。

查看详情

先用名称、简称或代码片段确认标准 ticker,再传给行情、估值、财务或宏观接口。

调用参数
参数类型必填默认说明
keywordstring-搜索关键词,例如 "平安"、"000001"。
data_typestring-数据类型过滤,可选 "A股"、"美股"、"港股"、"指数"、"宏观指标"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result[]object[]匹配到的代码候选列表。
result[].code / tickerstring可继续传给行情、估值、财务或宏观工具的标准代码。
result[].namestring证券、指数或宏观指标名称。
result[].data_typestring候选结果所属类型,例如 A股、美股、港股、指数或宏观指标。
返回说明

返回候选标的代码、名称、市场类型,以及宏观指标的单位、来源和样本覆盖信息。

search_code 参数示例
{
  "arguments": {
    "keyword": "平安",
    "data_type": "A股"
  }
}
search_code 返回示例
{
  "tool": "search_code",
  "arguments": {
    "keyword": "平安",
    "data_type": "A股"
  },
  "result": [
    {
      "ticker": "000001.SZ",
      "name": "平安银行",
      "data_type": "A股"
    }
  ]
}
get_basicinfo基础信息MCP / HTTP API

根据 A股 TRADE_CODE 查询公司基础信息。

查看详情

已知 A股代码时,用于读取公司名称、上市日期、地域、行业分类、主营业务和主要股东信息。

调用参数
参数类型必填默认说明
TRADE_CODEstring-A股股票代码,例如 "000001.SZ"、"600519.SH"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 compact_table 结构的公司基础信息,表头直接使用 db_schema.json 对应列 comment,例如 股票代码、股票名称、上市日期、申万一级行业、业务范围、大股东名称、大股东持股比例、更新日期;metadata 保留内部字段名和原始数据库列名。

get_basicinfo 参数示例
{
  "arguments": {
    "TRADE_CODE": "600519.SH"
  }
}
get_basicinfo 返回示例
{
  "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

获取股票或指数历史行情数据。

查看详情

按 ticker 和日期区间返回开高低收、成交量、成交额,以及当前真实表中可用的扩展字段。

调用参数
参数类型必填默认说明
tickerstring-证券代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。
start_datestring-开始日期,格式 YYYY-MM-DD。
end_datestring-结束日期,格式 YYYY-MM-DD。
data_typestring-数据类型,可选 "A股"、"美股"、"港股"、"指数"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 compact_table 结构的历史行情行,列随市场和底层数据表可用字段变化。

get_stock_market_history 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "data_type": "A股"
  }
}
get_stock_market_history 返回示例
{
  "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

获取股票或指数历史估值数据。

查看详情

用于查询 PE、PB、PS、分位数、股息率等当前数据源实际存在的估值字段。

调用参数
参数类型必填默认说明
tickerstring-证券代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。
start_datestring-开始日期,格式 YYYY-MM-DD。
end_datestring-结束日期,格式 YYYY-MM-DD。
data_typestring-数据类型,可选 "A股"、"美股"、"港股"、"指数"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 compact_table 结构的估值历史行,只包含当前数据源可用字段。

get_stock_valuation_history 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "data_type": "A股"
  }
}
get_stock_valuation_history 返回示例
{
  "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

通过指数代码获取指数成份股。

查看详情

输入指数代码,返回当前可用的成份股列表、权重和成份日期。

调用参数
参数类型必填默认说明
index_codestring-指数代码,例如 "000300.SH"、"000905.SH"、"399001.SZ"。
as_of_datestring-查询日期,格式 YYYY-MM-DD;不传默认为当前日期。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 compact_table 结构的成份股列表,字段包含 trade_code、weight、component_date。

get_index_components 参数示例
{
  "arguments": {
    "index_code": "000300.SH",
    "as_of_date": "2026-05-28"
  }
}
get_index_components 返回示例
{
  "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

获取宏观指标历史数据。

查看详情

先用 search_code 查找宏观指标代码,再按日期区间拉取历史观测值。

调用参数
参数类型必填默认说明
tickerstring-宏观指标代码,例如 "M0001385"。
start_datestring-开始日期,格式 YYYY-MM-DD。
end_datestring-结束日期,格式 YYYY-MM-DD。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回观测日期、数值,并附带单位、来源、最新观测日和样本覆盖范围等元数据。

get_macro_data 参数示例
{
  "arguments": {
    "ticker": "M0001385",
    "start_date": "2020-01-01",
    "end_date": "2024-12-31"
  }
}
get_macro_data 返回示例
{
  "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

获取股票财务报表与核心财务字段。

查看详情

支持按报告日期、财年、年报口径过滤,也可请求白名单扩展字段。

调用参数
参数类型必填默认说明
tickerstring-股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。
periodsinteger8返回期数,范围 1-500。
data_typestringall"all"、"balance_sheet"、"income_statement"、"cash_flow"、"key_metrics"。
market_typestring-市场类型,可选 "A股"、"美股"、"港股"。
start_datestring-按报告日期 DT 过滤的开始日期,格式 YYYY-MM-DD。
end_datestring-按报告日期 DT 过滤的结束日期,格式 YYYY-MM-DD。
fiscal_yearinteger-指定单个财年,按 DT 年份过滤。
start_yearinteger-起始财年,按 DT 年份过滤。
end_yearinteger-结束财年,按 DT 年份过滤。
annual_onlybooleanfalse是否只返回年报日期 12-31。
extra_fieldsstring-额外字段白名单,当前支持 "holder_pct_by_fund"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回财务结果集,包含报告日期、字段值和对应口径。

get_financial_data 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "data_type": "income_statement",
    "periods": 8,
    "annual_only": true
  }
}
get_financial_data 返回示例
{
  "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股股票一致预期历史。

查看详情

查询 FY1/FY2 收入、利润,以及同日可用的分歧度字段。

调用参数
参数类型必填默认说明
tickerstring-A股股票代码,例如 "000001.SZ"。
start_datestring-开始日期,格式 YYYY-MM-DD。
end_datestring-结束日期,格式 YYYY-MM-DD。
limitinteger120返回行数上限,范围 1-1000。
market_typestring-市场类型;当前仅支持 "A股"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回预测历史行;没有同日分歧度记录时不返回对应 std 字段。

get_stock_forecast_history 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "start_date": "2024-01-01",
    "end_date": "2024-12-31",
    "limit": 120
  }
}
get_stock_forecast_history 返回示例
{
  "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

计算并获取核心财务比率。

查看详情

查询 ROE、ROA、毛利率、净利率、资产负债率等指标。

调用参数
参数类型必填默认说明
tickerstring-股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。
periodsinteger4返回期数,范围 1-40。
market_typestring-市场类型,可选 "A股"、"美股"、"港股"。
end_datestring-锚点日期,格式 YYYY-MM-DD;返回不晚于该日期的最近 periods 期。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回按报告期排列的财务比率数据。

get_financial_ratios 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "periods": 4,
    "market_type": "A股"
  }
}
get_financial_ratios 返回示例
{
  "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

获取财务指标增长率。

查看详情

用于追踪营收、净利润、总资产、权益等增长趋势。

调用参数
参数类型必填默认说明
tickerstring-股票代码,例如 "000001.SZ"、"AAPL.O"、"0700.HK"。
periodsinteger8返回期数,范围 1-40。
market_typestring-市场类型,可选 "A股"、"美股"、"港股"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回按报告期排列的增长率数据。

get_financial_growth 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "periods": 8,
    "market_type": "A股"
  }
}
get_financial_growth 返回示例
{
  "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 API

A股多指标组合选股。

查看详情

传入行业、指标列表、上下限和时间位移,筛选满足条件的股票。

调用参数
参数类型必填默认说明
industrystring-申万一级行业名称,例如 "电子";传 "全部" 表示全市场。
ind_liststring[]-指标名称列表,例如 ["roe", "net_profit_yoy"]。
lower_listnumber[]-每个指标下限,与 ind_list 一一对应。
upper_listnumber[]-每个指标上限,与 ind_list 一一对应。
time_zone_listinteger[]-每个指标的时间位移;0 表示当前,N 表示未来 N 年。
limitinteger50返回记录数上限,范围 1-500。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回满足条件的 A股标的和指标值。

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
  }
}
screen_stocks 返回示例
{
  "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 可用指标。

查看详情

构造 screen_stocks 条件前,先查看可用指标名称和解释。

调用参数
无请求参数,传空对象即可。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
resultstring文本结果,包含检索摘要、匹配片段、指标说明或策略分析。
返回说明

返回可用于多指标选股的指标名称和说明。

list_indicators 参数示例
{
  "arguments": {}
}
list_indicators 返回示例
{
  "tool": "list_indicators",
  "arguments": {},
  "result": "返回文本摘要、匹配片段或指标说明。"
}
get_stock_excess_return收益MCP / HTTP API

计算 A股个股相对申万行业指数的超额收益。

查看详情

用于观察个股相对行业基准在一段时间内的收益表现。

调用参数
参数类型必填默认说明
tickerstring-A股股票代码,例如 "000001.SZ"。
date_benchmarkstring-基准日期,格式 YYYY-MM-DD。
daysinteger250统计天数,范围 1-1000。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回个股收益、行业基准收益和超额收益。

get_stock_excess_return 参数示例
{
  "arguments": {
    "ticker": "000001.SZ",
    "date_benchmark": "2024-01-01",
    "days": 250
  }
}
get_stock_excess_return 返回示例
{
  "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

搜索美股公司财报会议纪要。

查看详情

用公司名称、股票代码或问题关键词检索电话会和管理层问答。

调用参数
参数类型必填默认说明
keywordstring-搜索关键词,例如 "Apple"、"AAPL"。
limitinteger10返回结果数量,范围 1-100。
content_modestringmatched内容返回模式:matched 返回最相关的匹配内容;full 返回完整纪要正文。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回文本摘要,并在结构化结果中提供纪要标识、ticker、公司、文件、日期、相关度和内容;默认内容为最相关的匹配内容,content_mode=full 时为完整纪要正文。

search_us_transcript 参数示例
{
  "arguments": {
    "keyword": "AAPL guidance",
    "limit": 10,
    "content_mode": "matched"
  }
}
search_us_transcript 返回示例
{
  "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股公司调研纪要。

查看详情

按问题、公司名或股票代码检索投资者关系活动记录。

调用参数
参数类型必填默认说明
keywordstring-语义搜索关键词,例如 "毛利率下降原因"。
limitinteger10返回结果数量,范围 1-50。
company_namestring-按公司名称过滤,例如 "宁德"。
stock_codestring-按股票代码精确过滤,例如 "300750"。
start_datestring-开始日期,格式 YYYY-MM-DD;传入后按 create_date 硬过滤并关闭时间衰减。
end_datestring-结束日期,格式 YYYY-MM-DD;传入后按 create_date 硬过滤并关闭时间衰减。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回文本摘要,并在结构化结果中提供股票代码、公司、标题、会议时间、发布时间、相关度和调研内容正文;未传日期范围时使用时间衰减排序。

search_cn_transcript 参数示例
{
  "arguments": {
    "keyword": "毛利率下降原因",
    "company_name": "宁德",
    "start_date": "2022-02-15",
    "end_date": "2022-10-13",
    "limit": 10
  }
}
search_cn_transcript 返回示例
{
  "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

搜索图表。

查看详情

用宏观、行业或指标关键词查找可用图表;拿到图表 ID 后可继续查看 chart_settings 并获取真实图表数据。

调用参数
参数类型必填默认说明
keywordstring-搜索关键词,例如 "GDP增速"、"居民消费"。
limitinteger10返回结果数量,范围 1-100。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回文本摘要,并在结构化结果中提供图表 ID、标题和相关度。

search_chart 参数示例
{
  "arguments": {
    "keyword": "GDP增速",
    "limit": 10
  }
}
search_chart 返回示例
{
  "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(图表渲染参数定义)。

查看详情

已知图表 ID 时,先读取 chart_settings。它不是图表数据,而是可传给 get_chart_data.selection_values 的 varname、默认值、候选项和日期约束。

调用参数
参数类型必填默认说明
chart_idinteger-图表 ID,例如 9258;可先用 search_chart 查找。
include_dynamic_optionsbooleantrue是否展开 tmpl 类型 chart_settings 的动态候选值。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 compact_table chart_settings 表,并在顶层 resolved_setting 给出默认选择值。

get_chart_settings 参数示例
{
  "arguments": {
    "chart_id": 9258,
    "include_dynamic_options": true
  }
}
get_chart_settings 返回示例
{
  "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_settings 确认 chart_settings.varname 后,传入 selection_values 获取对应真实渲染数据。

调用参数
参数类型必填默认说明
chart_idinteger-图表 ID,例如 9258;可先用 search_chart 查找。
selection_valuesobject-选择值,键为 chart_settings.varname,会覆盖默认值。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 resolved_setting 和 compact_table 数据集。

get_chart_data 参数示例
{
  "arguments": {
    "chart_id": 9258,
    "selection_values": {
      "industry": "消费"
    }
  }
}
get_chart_data 返回示例
{
  "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

搜索财经新闻资讯。

查看详情

用自然语言问题或关键词检索当前财经新闻;服务端固定使用财经主题。

调用参数
参数类型必填默认说明
querystring-财经新闻搜索问题或关键词,例如 "AI earnings"、"美联储 降息"。
max_resultsinteger5返回结果数量,范围 1-20。
time_rangestring-按发布或更新时间过滤,可选 day/week/month/year 或 d/w/m/y。
start_datestring-开始日期,格式 YYYY-MM-DD。
end_datestring-结束日期,格式 YYYY-MM-DD。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回文本摘要,并在结构化结果中提供标题、URL、相关度、内容片段和 favicon;metadata 包含请求 ID、响应耗时和用量信息。

search_news 参数示例
{
  "arguments": {
    "query": "AI earnings",
    "max_results": 5,
    "time_range": "week"
  }
}
search_news 返回示例
{
  "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

自然语言金融数据查询工具。

查看详情

直接描述想要的数据,适合探索式查询或跨表组合查询。

调用参数
参数类型必填默认说明
querystring-自然语言查询,例如 "获取茅台的行情数据和财务数据"。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
result.messagestring本次工具调用的结果摘要。
result.data[]object[]一个或多个结构化结果集。
result.data[].formatstring结果集格式;表格结果通常为 "compact_table"。
result.data[].columnsstring[]表格列名,按 rows 中每行的值顺序排列。
result.data[].rowsarray[]二维数组形式的数据行,避免每行重复字段名。
result.creditsstring额度计算说明;实际扣费以调用日志记录为准。
返回说明

返回 message 加 data 的结构化结果,通常使用 compact_table 表示表格数据。

get_data 参数示例
{
  "arguments": {
    "query": "获取茅台近一个月行情和最近四期财务数据"
  }
}
get_data 返回示例
{
  "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

非结构化投资研究和观点检索。

查看详情

描述研究问题,返回匹配研究材料和观点线索。

调用参数
参数类型必填默认说明
querystring-自然语言研究查询,描述你想了解的内容。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
resultstring文本结果,包含检索摘要、匹配片段、指标说明或策略分析。
返回说明

返回研究摘要、来源材料和可追溯内容片段。

get_research 参数示例
{
  "arguments": {
    "query": "近期消费电子行业景气度有哪些变化"
  }
}
get_research 返回示例
{
  "tool": "get_research",
  "arguments": {
    "query": "近期消费电子行业景气度有哪些变化"
  },
  "result": "返回文本摘要、匹配片段或指标说明。"
}
get_strategy语义查询MCP / HTTP API

A股多指标组合选股与历史超额收益回测。

查看详情

用自然语言描述选股策略,由系统转成指标条件并给出筛选和回测结果。

调用参数
参数类型必填默认说明
strategy_descriptionstring-自然语言描述选股策略,包括行业、指标条件和目标。
返回字段
返回字段类型说明
toolstring本次调用的工具名。
argumentsobject服务端校验后实际执行的参数。
resultstring文本结果,包含检索摘要、匹配片段、指标说明或策略分析。
返回说明

返回策略解析、候选股票和历史超额收益结果。

get_strategy 参数示例
{
  "arguments": {
    "strategy_description": "在电子行业中筛选 ROE 高于 10 且净利润增速高于 20 的股票"
  }
}
get_strategy 返回示例
{
  "tool": "get_strategy",
  "arguments": {
    "strategy_description": "在电子行业中筛选 ROE 高于 10 且净利润增速高于 20 的股票"
  },
  "result": "返回文本摘要、匹配片段或指标说明。"
}
greet连接测试仅 MCP

打招呼工具,用于测试 MCP 服务器连接和鉴权是否成功。

查看详情

完成 MCP 端点和 Bearer Token 配置后,可用这个工具做最小化连通性检查;该工具仅通过 MCP tools/list 与 tools/call 暴露。

调用参数
参数类型必填默认说明
namestring-要打招呼的名称,例如 "World"。
返回字段
返回字段类型说明
content[].typestringMCP 内容类型,文本结果为 "text"。
content[].textstring工具返回的文本内容;结构化业务工具会在这里放入完整 JSON 结果。
返回说明

返回纯文本问候语,例如 "Hello, World!"。

greet 参数示例
{
  "arguments": {
    "name": "World"
  }
}
greet 返回示例
{
  "content": [
    {
      "type": "text",
      "text": "Hello, World!"
    }
  ]
}

调用入口与示例

下面只保留必要的调用地址和请求结构;客户端配置、Token 创建和排障流程请查看接入指南。

服务地址
https://vmcp.hzinsights.com/

HTTP API 和公开资源的生产基准地址。

MCP 端点
https://vmcp.hzinsights.com/mcp/

MCP 客户端配置地址,使用 tools/list 与 tools/call。

发现工具
https://vmcp.hzinsights.com/api/v1/tools

HTTP API 方式列出工具名、描述和 input_schema。

调用工具
https://vmcp.hzinsights.com/api/v1/tools/{tool_name}/call

HTTP API 请求体固定为 { arguments: { ... } }。

MCP 工具调用
{
  "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股"
    }
  }
}
HTTP API 调用
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": "按实际返回量计算"
}