curl 示例假设已执行 export WM_KEY="wm_…"；使用 OAuth 时，请将 -H "X-WorldMonitor-Key: $WM_KEY" 替换为 -H "Authorization: Bearer $TOKEN"。
get_world_brief
来自仪表板使用的预计算 news:insights:v1 快照的有引用依据的世界情报简报。洞察种子程序在发布前应用交叉印证、引用和幻觉检查；该工具读取已接受的结果，不会在请求时调用 LLM。可选的 geo_context 字段为兼容客户端保留，不会改变种子快照。
参数：
- API 端点：
GET /api/infrastructure/v1/get-bootstrap-data?keys=insights—— 通过已认证网关读取仪表板使用的同一news:insights:v1payload。 - 类型： 缓存支撑的 RPC。付费打开消耗一个世界简报面板额度；有效期内的健康重复读取和 JMESPath 视图复用已接受的原始快照。有效且不足三小时的最近可用内容仍可返回，并显示过期提示，但过期内容允许重试，不会作为新鲜快照缓存。缺失、损坏或超过期限的内容不可用。不在请求时调用 LLM。API 保持普通逐工具计费，免费账户保持订阅拒绝行为。
- 来源： 按生产者顺序返回种子 payload 发布的有界
worldBriefSources数组。URL 从显式来源记录复制，而不是在 MCP 执行时生成；保留空 URL 回退项，避免引用编号错位。 - 交叉印证：
headlines中的每一项在topStories中都有一个按下标对齐的条目（topStories[i]描述headlines[i]），包含sourceCount、uniqueSourceCount、corroborationSourceCount、entityCorroboration、sourceTier，以及sources中参与报道的媒体名称（上限 12 个）。这些全部由洞察种子程序发布，因此不在请求时计算。注意这里每个故事的sources是媒体名称列表，与该工具顶层的sources（承载引用记录）不同。memberTitles在此处刻意不返回 —— 它可在输出预算更大的get_news_intelligence上获取。 - 来源溯源： 每个
topStories[i]还带有sourceProvenance，与其sources按下标对齐（sourceProvenance[j]描述sources[j]）。每一项给出该媒体声明的tier（1–4，未登记时为null）、risk、type，以及它们是否已声明和已审核（riskDeclared、typeDeclared、riskReviewed、typeReviewed）；登记了关联方时给出stateAffiliated，另有knownBiases（人工整理的立场标签；空数组表示尚未记录标签，并不代表该媒体中立）和可选的note。这与get_news_clusters返回的逐媒体记录相同，只是没有summary；它能显示同一故事同时引用一级通讯社和高风险或国家关联媒体的情况，而仅看sourceTier看不出这一点。没有媒体列表的故事不带溯源。若响应会超出输出预算，先删除所有note，仍不够时才删除所有sourceProvenance列表；此时transportCoverage会标明被裁剪的字段，omission_reason为"output_budget"。媒体名称和sourceTier始终返回。
analyze_situation
AI 地缘政治局势分析（DeductionPanel）。提供查询和可选的地缘政治上下文；返回带置信度和支持信号的 LLM 驱动的分析推演。
参数：
- API 端点：
POST /api/intelligence/v1/deduct-situation - 类型： 实时 RPC — 每次调用代理对 WorldMonitor API 的请求。Edge 运行时超时：25.0s。
get_forecast_predictions
来自 WorldMonitor 预测模型的 AI 生成地缘政治和经济预测。涵盖即将到来的风险事件和概率评估。
参数（工具特定）：
每项还包含
firstSeenAt（ISO 时间）、firstSeenProbability、change24h 和 change7d（概率绝对变化）。轨迹缺失或不足时返回 null。地区变化会开始新片段；首次写入只回填仍保留的历史，因此 firstSeenAt 可能晚于最初发布时间。历史点为 [isoTime, probability]，采样可能有空档。
- API 端点：
GET /api/forecast/v1/get-forecasts - 类型： 缓存读取 — 来自 Redis 引导缓存的亚秒级响应。
- 新鲜度预算： 标记
stale: true前最多 1.5 小时（由 seeder cron 的预期间隔设定）。
get_forecast_case
读取指定 ID 和列表 generation 对应的原始预测案例，保留案例内容。专用 MCP 套餐需要有效的付费预测面板准入：现有的 64 次读取额度包含此读取，不会额外扣减每日面板配额。API 套餐无法持有面板，无需 panel_request 即可读取，按工具的常规单次权重计费。generation 已更改时返回 generation_changed 且不含案例。缺少数据源、ID 不存在、generation 已更改或单个案例超出大小限制时，都会明确报告。数据源恢复后可重试失败的案例；成功的案例会被复用。
参数（工具特定）：
- API 端点：
GET /api/forecast/v1/get-forecasts - 访问权限：
subscription。专用 MCP 套餐需要通过所有者、范围、有效期和权益检查的有效付费预测面板准入；API 套餐按次计费。 - 类型： 读取固定规范预测数据集的缓存；不会访问任意缓存键，也不会运行模型生成。
- 输出上限： 单个完整原始案例为 128 KB；不会静默截断案例内容。
- 新鲜度预算： 1.5 小时；原始案例的数据源通知与打开面板时的快照分开处理。
get_forecast_theaters
读取最新原始模拟战区摘要。专用 MCP 套餐需要有效的付费预测准入；API 套餐无需 panel_request，按工具的常规单次权重计费。保留原始路径、参与者及可选角色、反应、稳定因素、失效条件、独立来源运行 ID 和时间以及完成计数。来源时间不能证明新鲜度；部分和未知覆盖不会被视为完整覆盖或空结果。
参数（工具特定）：
- API 端点：
GET /api/forecast/v1/get-simulation-outcome，只读取最新摘要。 - 访问权限：
subscription，检查所有者、范围、有效期和权益。 - 配额： 专用 MCP 套餐共享打开面板时的每日分配和 64 次未缓存读取上限；API 套餐每次调用按工具权重计费。完整且通过验证的快照及明确无符合条件的空快照可以复用；部分、失败、缺失、处理中及未知结果可以手动重试。
- 输出上限： 原始证据为 128 KB。无效或过大的来源报告不可用，不会静默截断，不支持任意运行选择、模拟触发或私有产物读取。
get_forecast_scorecard
预测结算记分卡，含校准、Brier/对数分数、领域和生成来源细分，以及待判/已判结算计数。
参数（工具专用）：
归档返回当前评分卡的
underAudit、归档 seed-meta 的 archive.stale（36 小时预算）以及 nextBefore（末页为 null）。摘要形状保持不变。仅指定 forecast_id 时返回轨迹，不会借用其他地区的轨迹。归档使用公开凭证字段白名单，不含原始账本、评审理由、新闻归档内容或内部指标路径。历史结算可能大多为 VOID；归档本身不能证明预测能力。
- API 端点：
GET /api/forecast/v1/get-forecast-scorecard - 类型： 缓存读取 — 来自 Redis 引导缓存的亚秒级响应。
- 新鲜度预算： 标记
stale: true前最多 36 小时（每日结算器节奏，含漏跑 cron 容差）。