MCP 接口文档

明乐智保保险数据 MCP 接口文档

面向接入方与审核人员的接口说明:服务端点、传输协议、OAuth 2.1 授权、9 个工具的参数与返回结构、错误码与调用示例。完整参数与返回字段以 llms-full.txt 与连接后 tools/list 返回为准。

9 个工具7 个场景菜谱Streamable HTTPOAuth 2.1

一、接入信息

服务端点
https://minglezhibao.cn/api/mcp
传输协议
Streamable HTTP
鉴权方式
OAuth 2.1(推荐)或 API Key
工具与菜谱
9 个工具 + 7 个场景菜谱
协议
JSON-RPC 2.0 / MCP
文档版本
2026-11-18

二、鉴权与发现

推荐使用 OAuth 2.1。客户端首次调用未授权时,服务端返回 401 与 WWW-Authenticate,客户端可按下列元数据自动发现授权服务,完成动态注册与浏览器授权。授权码模式使用 PKCE S256,公共客户端无需 Client Secret。

用途地址
受保护资源元数据https://minglezhibao.cn/.well-known/oauth-protected-resource
授权服务元数据https://minglezhibao.cn/.well-known/oauth-authorization-server
授权页https://minglezhibao.cn/oauth/authorize
Tokenhttps://minglezhibao.cn/api/oauth/token
动态注册https://minglezhibao.cn/api/oauth/register
吊销https://minglezhibao.cn/api/oauth/revoke

Scopes 为 mcp。服务端到服务端的应用对接可使用 API Key:请求头 x-api-key,凭证由专业版账号在官网「我的订阅」生成。

审核联调:授权页支持微信扫码登录;如需专用测试账号,请在提交连接器时备注,我们会配合开通。

三、工具清单

工具用途关键参数主要返回
search发现入口:产品、公司、评分维度、地区、可用年份、指标字典。`kind`(product / company / dimension / region / year / dictionary);keyword、companyKey、category、limit、offset。列表数据;产品结果带 `dataStatus.catalogOnly`,列表带 `total` / `returned` / `truncated`。
get_product单产品详情、重疾责任、现金价值、同类竞品、公司产品线、可投参数。`view`(detail / illness / cash / competitor / overview / input_options);productKey;按视图传投保参数。产品详情或对应视图数据;目录产品带 `dataStatus`。
get_company单公司画像或综合评分排名。`view`(profile / ranking);companyKey。综合评分、维度排名、财务摘要、偿付能力、分红表现。
get_market经营指标、财务、偿付能力、地区保费、维度排名、偿付红线、产品评测。`dataset`(metric / financial / solvency / premium / dimension_ranking / breached / estimate);view、companyKey、region、year。指标值;按数据集返回 `basis` / `unit` / `position` / `regulatory` 等口径字段。
get_ops季度经营指标横截面、业务结构、单指标跨期序列、同业态排名。`view`(metrics / structure / series / ranking);companyKey、year、period、dataType。季度指标 + `regulatory` / `position`;排名结果带 `peerType`(LIFE / PC)与可比性字段。
get_rate分红实现率与万能险结算利率。`kind`(dividend / universal);view;companyKey、year、month、productName、limit、offset。分红实现率或结算利率数据;`by_month` 默认按利率降序返回前 50 条。
calculate投保利益、保费与保额换算、费率表原值。`action`(benefit / fee / fee_rate);productKey + 年龄、性别、缴费期、保费或保额、保障期。利益表、换算结果或费率表;需代理人身份与付费套餐,受限时返回 403 引导。
get_chart_link生成官网数据页深链或交互式图表链接。`deepLink`,或 `chartType` / `title` / `unit` / `data`(2~20 条,数据须来自前序工具)。官网深链或图表 H5 链接。
submit_insurance_need提交用户保险需求,交由专业顾问跟进。`source`(必填,如 `dumate`);ageRange、budget、concern、city、productInterest。需求编号、摘要与追踪链接;不占调用额度。

每个工具的完整 inputSchema、字段说明与返回字段见连接后 tools/list 或 llms-full.txt。companyKey / productKey 支持中文名直传。

四、调用示例

tools/list
curl -s https://minglezhibao.cn/api/mcp \
  -H "Authorization: Bearer $MCP_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
tools/call
curl -s https://minglezhibao.cn/api/mcp \
  -H "Authorization: Bearer $MCP_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_company","arguments":{"view":"profile","companyKey":"平安人寿"}}}'

五、返回结构与错误码

成功响应遵循 JSON-RPC 2.0,结果位于 result,工具正文位于 result.content。常见口径字段包括 basis、unit、position、comparable、regulatory。

状态含义处理建议
401凭证缺失、无效或已过期重新完成 OAuth 授权;确认账号登录态与订阅状态
403身份或套餐限制(含 calculate / 竞品视角)按 guidance 升级套餐,或改用 submit_insurance_need
429当日调用额度已用完次日重试或升级套餐,不重试刷额度
400 / JSON-RPC error参数缺失或取值不合法按错误信息修正;用 tools/list 查看 inputSchema

六、场景菜谱

服务端提供 7 个 MCP prompts,用于多工具组合场景的分步指引,不计调用额度。客户端支持 prompts 时可通过 prompts/list / prompts/get 获取。

company_scan 公司实力体检industry_ranking 行业排名dividend_universal 分红万能速查company_compare 公司对比product_review 产品测评product_compare 产品对比pension_planning 养老利益测算

七、数据与合规

数据来源:官方公开信息披露。数据仅供参考,最终以保险公司官方披露与保险条款为准。

本服务仅提供公开标准化数据查询与解读,不提供投保建议、不评判产品收益优劣、不承诺回报、不做理赔结论。

分红实现率、结算利率、利益数据均为历史或假设情景数据,不构成未来收益承诺。

八、完整参考与接入

完整参数、返回字段与示例:https://minglezhibao.cn/llms-full.txt

简化能力清单:https://minglezhibao.cn/llms.txt

客户端接入说明:https://minglezhibao.cn/mcp

服务端点:https://minglezhibao.cn/api/mcp