香港保险数据 API (HK Insure MCP)

远程 MCP 服务，提供香港市场 260+ 真实保险产品的结构化数据：储蓄险（含建议书实测 IRR20/IRR30、保证/预期回本年）、寿险、医疗险、危疾险、年金险，以及 17 家保司的历年分红实现率（2559 条记录）。数据来自保司官方渠道及持牌经纪人建议书系统，带来源可验证。

• MCP 端点: https://insurance.mytreasure.ren/api/mcp/mcp（Streamable HTTP）
• 认证: Bearer token，key 以 hkins_ 开头
• 免费额度: 注册即送 50 次调用
• 付费价格: ¥10 / 1000 次调用；当前限时优惠 ¥0.1 / 1000 次（约等于白送，早用早享受）
• 网站: https://insurance.mytreasure.ren （产品浏览/对比/退休计算器均免费）

第一步：注册拿 API Key（一次性）

需要一个邮箱。流程中有一步「点邮件验证链接」必须人工完成，agent 应引导用户操作：

1. 打开注册页：https://insurance.mytreasure.ren/dev/login，切换到「注册」，填邮箱+密码（≥6位）提交
2. 邮箱验证（人工步骤）：系统发送验证邮件，发件人 noreply@mail.mytreasure.ren。提醒用户：
   • 大概率进垃圾邮件箱，找不到先查垃圾箱
   • 标记「非垃圾邮件」后点击邮件中的验证链接
3. 回到 /dev/login 登录 → 进入开发者中心 /dev
4. 点「生成 API Key」→ 明文 key 只显示这一次，立即复制保存
5. 把 key 交给 agent 配置（见下）。重新生成会使旧 key 立即失效

如果用户已配置邮箱 CLI（如 himalaya），agent 可以代查验证邮件并提取链接，但点击链接后的会话仍建议用户在浏览器完成。

第二步：配置

把 key 存为环境变量（绝不硬编码到脚本/对话里）：

export HKINS_API_KEY=hkins_xxxx   # 写入 ~/.zshrc 或 ~/.bashrc

Hermes 用户也可以把此 MCP 挂为远程工具服务器（mcp_servers 配置，Streamable HTTP + bearer auth），或直接用下面的 curl 模式调用。

第三步：调用（JSON-RPC 2.0）

MCP 标准 Streamable HTTP。最简单的调用模式（curl + jq）：

# 1. initialize（每个会话开头调一次）
curl -s -X POST https://insurance.mytreasure.ren/api/mcp/mcp 
  -H "Authorization: Bearer $HKINS_API_KEY" 
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" 
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"agent","version":"1.0"}}}'

# 2. 列出工具
curl -s -X POST https://insurance.mytreasure.ren/api/mcp/mcp 
  -H "Authorization: Bearer $HKINS_API_KEY" 
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" 
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. 调用工具（示例：储蓄险按IRR排序取前5）
curl -s -X POST https://insurance.mytreasure.ren/api/mcp/mcp 
  -H "Authorization: Bearer $HKINS_API_KEY" 
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" 
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_products","arguments":{"type":"savings","limit":5}}}'

响应可能是 SSE 格式（data: 行），解析时取 data: 后的 JSON。

可用工具（5个）

典型场景

• 「对比保诚和友邦的储蓄险哪个IRR高」→ search_products 各拿 id → compare_products
• 「20年IRR最高的储蓄险前五」→ list_products(type=savings) 按 projectedIRR20 排序
• 「XX保司的分红实现率怎么样」→ list_insurers 或 get_product 看 dividend_fulfillment_rate
• 用于投资分析文章、保险经纪展业、退休规划测算的数据源

Pitfalls

• 401 invalid_token：key 错误/已被重置（重新生成会使旧 key 失效）
• 额度用尽：免费 50 次用完后调用被拒，到 /dev 购买调用包（¥10/1000次，当前优惠 ¥0.1/1000次，微信支付）
• 每日配额：付费套餐有日调用上限，超出当日被限，次日恢复
• 响应是 SSE 流格式时，逐行取 data: 前缀后的 JSON 再解析
• IRR 数据基于「38岁男/非吸烟」建议书演示场景，其他年龄/性别会有差异——用于对比排序可靠，用于精确报价需向持牌经纪索取个性化建议书
• 年金类产品进入年金期后退保价值下降，IRR30 可能为负数，是真实数据不是错误
• 数据为简体中文；产品名/保司名搜索用中文效果最好

免责声明

数据仅供参考，不构成投资或投保建议。保险产品的非保证收益（红利）取决于保司投资表现。投保决策请咨询持牌保险顾问。