只读六工具
MCP 是与 REST 平级的交付面，走同一个服务层，所以权限与来源规则不在这里重写。stdio 传输，JSON-RPC 2.0，每行一条消息；标准库实现，无新增依赖。
工具
名称与参数来自服务端工具表；契约门禁 对每个工具、每个层级检查来源、时点与核验状态。
| 工具 | 参数 | 返回 | 口径行 |
|---|---|---|---|
| fama_search_listings | city, status (open / sold / failed / withdrawn ...), channel (judicial_auction / authorized_supply), source, q（标题关键词），limit (1-200), cursor（上一页的 next_cursor）；均可选 | 本密钥可见的困境资产条目，每条带 provenance | listings |
| fama_get_passport | listing_uid（必填） | 砝码护照：字段、双轴核验状态、处置时间线、交易、来源谱系、变更记录 | passport |
| fama_get_sources | listing_uid（必填） | 来源谱系：解析到该标的的每条外部记录及 first / last seen | passport |
| fama_subject_brief | listing_uid（必填） | 标的简报，数据与 Markdown 两种形态，附规则附录 | passport |
| fama_coverage | 无 | 数据层覆盖：按来源与城市的计数、司法字段完整度、三态分布 | coverage |
| fama_calc | kind（必填：investment / transfer / daiya / two_outcomes），payload（测算输入，见 /v1/methodology） | 测算结果；一律为 估算 态 | calc |
运行
- 密钥决定层级，与 /v1 完全一致；接入配置随密钥一同提供。
- 没有密钥时服务拒绝启动，开放匿名访问的部署除外（public 层）。
- 客户端按 MCP stdio 传输连接；协议版本 2025-06-18；能力只有 tools (listChanged: false)。
同一服务层
工程标准 2.4: MCP 工具与 REST 接口共用同一服务层，禁止两套逻辑。可见性、internal 字段下渗（INTERNAL_ONLY_FIELDS）、来源 source_id 的隐藏，都在服务层一次实现，MCP 调用的是同一组函数。
冻结说明
六个工具全部只读，没有写操作。按公司级冻结清单，/v1 + MCP 维持现状，只读六工具不再加，直至第一份付费或含价条款的数据合同签署；向公开 MCP 清单 / 目录的登记同在冻结之列。工具一旦有外部调用方，弃用政策 即成合同级义务。