get_food_stocks。
curl 示例假设已执行 export WM_KEY="wm_…"；使用 OAuth 时，请将 -H "X-WorldMonitor-Key: $WM_KEY" 替换为 -H "Authorization: Bearer $TOKEN"。
get_wto_trade_flows
查询一个报告国与世界之间、可配置年份窗口内的 WTO 商品贸易流量。数据来自 WTO ITS_MTV_AX（出口）和 ITS_MTV_AM（进口）指标，每 6 小时播种一次；该工具读取与仪表板相同的播种快照，不会在每次请求时调用 WTO。
参数（工具特定）：
响应区分：
unavailableReason 使用 RPC 的封闭 TradeFlowUnavailableReason 枚举。TRADE_FLOW_UNAVAILABLE_REASON_NOT_COVERED 是合约答案：该组合不在播种覆盖范围内，重试无效。其他非 UNSPECIFIED 原因均表示故障（seed_missing、coverage_unknown、cache_unavailable），并带有 upstreamUnavailable: true。
- API 端点：
GET /api/trade/v1/get-trade-flows - 类型： 规范贸易流量路由的 RPC 代理（handler 负责窗口切片和未命中分类）。
- 新鲜度预算： 最多 7 小时后标记为
stale（6 小时播种节奏加 1 小时宽限）。
get_tariff_averages
一个国家按年份适用的平均关税：截至 2023 年的税则税率，不含 301/232 条款关税。不传伙伴和产品组时，返回任一报告国的 WTO 全部产品 MFN 平均税率（TP_A_0010），包括美国（840）。传入非“世界”的伙伴或产品组时，返回来自 UNCTAD TRAINS（经 World Bank WITS）的实际适用平均税率：
tariffRate为简单平均（AHS-SMPL-AVRG），计入该伙伴可享受的优惠。weightedRate为进口加权平均（AHS-WGHTD-AVRG）。
get_us_import_duty。
参数（工具特定）：
响应区分： 每个数据点的
indicatorCode、partnerCountry 和 productSector 说明由哪个序列作答。TARIFF_TREND_UNAVAILABLE_REASON_NOT_COVERED 是覆盖范围答案（WITS 没有该序列）。TARIFF_TREND_UNAVAILABLE_REASON_UPSTREAM_UNAVAILABLE 是故障，并带有 upstreamUnavailable: true；请稍后重试。
覆盖范围： 除上游故障外，每个答案都带有一个由 MCP 服务器添加的 coverage 对象。上游故障（upstreamUnavailable: true）不提供任何答案，因此不带该对象。dataset 表示所查询的数据集；信任税率之前，请先检查 unavailableReason。它在未传入非“世界”伙伴且未传入产品组时为 WTO_MFN，否则为 WITS_TRAINS。rateBasis 为 SCHEDULE，includesUnilateralDuties 为 false，excludedDutyTypes 列出 SECTION_301、SECTION_232、IEEPA、ANTI_DUMPING 和 COUNTERVAILING。latestYear 取 coverageEndYear，没有时取最新数据点的年份，没有任何年份作答时不出现。报告国为美国时，seeAlso 指向 get_us_import_duty 并说明原因。
- API 端点：
GET /api/trade/v1/get-tariff-trends - 访问：
subscription— 需要 Pro 订阅。RPC 工具：无summary参数（使用jmespath精简响应）。 - 类型： 规范路由的 RPC 代理。伙伴和产品组序列在缓存未命中时从 WITS 读取，并缓存 7 天。
get_bilateral_tariff
两国之间某一 HS6 产品的关税：截至 2023 年的税则税率，不含 301/232 条款关税。即一个国家在某一年对来自某一伙伴的某个 6 位 HS 产品适用的关税，来自 UNCTAD TRAINS（经 World Bank WITS）。appliedRate 是该伙伴实际支付的税率：其可享受的最优优惠税率，否则为 MFN。basis 说明是哪一种。mfnRate、preferentialRate 和按协定列出的 groupPreferences 分别报告。MFN 为从量税时，mfnAveRate 给出从价等值。欧盟成员国按欧盟税则作答（filingReporter 为 918）。
仅为税则税率：不包含 301 条款、232 条款、反倾销及其他单边关税。TRAINS 没有 2021 年以后的美国优惠数据，也没有 2023 年以后的美国数据，因此美国请使用 get_us_import_duty。
参数（工具特定）：
响应区分：
BILATERAL_TARIFF_UNAVAILABLE_REASON_NOT_COVERED 是覆盖范围答案。BILATERAL_TARIFF_UNAVAILABLE_REASON_UPSTREAM_UNAVAILABLE 是故障，并带有 upstreamUnavailable: true。
覆盖范围： 除上游故障外，每个答案都带有一个由 MCP 服务器添加的 coverage 对象。上游故障（upstreamUnavailable: true）不提供任何答案，因此不带该对象。dataset 表示所查询的数据集；信任税率之前，请先检查 unavailableReason。它始终为 WITS_TRAINS。rateBasis 为 SCHEDULE，includesUnilateralDuties 为 false，excludedDutyTypes 列出 SECTION_301、SECTION_232、IEEPA、ANTI_DUMPING 和 COUNTERVAILING。latestYear 为作答的年份，NOT_COVERED 答案中不出现。报告国为美国时，seeAlso 指向 get_us_import_duty 并说明原因。
- API 端点：
GET /api/trade/v1/get-bilateral-tariff - 访问：
subscription— 需要 Pro 订阅。RPC 工具：无summary参数（使用jmespath精简响应）。 - 类型： 规范路由的 RPC 代理，缓存未命中时读取 WITS。冷读取可能需要数秒。
get_us_import_duty
美国当前对来自某国的某一产品征收的关税：实时 HTS 税率，加上现行有效的 301 条款和 232 条款关税（如适用）。对 hs_code 下的每个 8 位税目，返回 USITC 协调关税表（HTS）的实时税率和 basis（MFN、带 preferenceProgram 的 PREFERENTIAL，或 COLUMN_2）。同时返回现行有效的第 99 章 301 条款和 232 条款关税，每项带有 status：
APPLIESCONDITIONAL，并以condition说明取决于什么EXEMPTSCHEDULED
estimatedRate 只把 APPLIES 关税加到基础税率上。当从量税、条件或未解析的优惠项目使结果不确定时，estimateComplete 为 false。IEEPA 关税已停止征收，不予报告。不包含反倾销税和反补贴税。additionalDutiesLoaded: false 表示只有基础税率可用。
参数（工具特定）：
覆盖范围： 除上游故障外，每个答案都带有一个由 MCP 服务器添加的
coverage 对象。上游故障（upstreamUnavailable: true）不提供任何答案，因此不带该对象。dataset 表示所查询的数据集；信任税率之前，请先检查 unavailableReason。它为 USITC_HTS，rateBasis 为 CURRENT_DUTY。只有 additionalDutiesLoaded 为 true 时，includesUnilateralDuties 才为 true，此时 excludedDutyTypes 列出 IEEPA、ANTI_DUMPING 和 COUNTERVAILING。否则答案仅含基础税率：includesUnilateralDuties 为 false，excludedDutyTypes 还会列出 SECTION_301 和 SECTION_232。asOf 为作答的 HTS 版本。
- API 端点：
GET /api/trade/v1/get-us-import-duty - 访问：
subscription— 需要 Pro 订阅。RPC 工具：无summary参数（使用jmespath精简响应）。 - 类型： 规范路由的 RPC 代理：实时读取 HTS 税目，并与播种的第 99 章目录（
trade:us-hts:catalog:v1）合并。
get_consumer_prices
逐国消费价格情报：30 天概览、类别级通胀、零售商价差（必需品篮子）、涨跌榜和来源新鲜度。需要 country_code（当前仅播种 ‘ae’）。
参数：
- API 端点：
GET /api/consumer-prices/v1/get-consumer-price-freshness,GET /api/consumer-prices/v1/get-consumer-price-overview,GET /api/consumer-prices/v1/list-consumer-price-categories,GET /api/consumer-prices/v1/list-consumer-price-movers,GET /api/consumer-prices/v1/list-retailer-price-spreads - 类型： 混合 — 直接读取缓存键（亚秒级），但需要输入参数来选择切片。
- 新鲜度预算： 每个切片最多 25 小时（24 小时 cron + 1 小时宽限）后标记
stale: true。
get_procurement_opportunities
通过规范的、仅限 Pro 的招标 API 搜索活跃的全球公共采购机会。此工具绝不直接读取 Upstash。它返回规范记录的紧凑投影：官方公告 URL、来源、标题、买方、时间、金额、分类、领域、participationMode 与精简的 automationFit；有意省略描述、资格要求和提交 URL。
参数（工具特定）：
- API 端点：
GET /api/economic/v1/list-global-tenders - 类型： 受预算约束的规范路由代理——Pro 权益仍由下游路由强制执行；不暴露 bootstrap 或直接缓存读取。
- 输出预算： 默认 10 条紧凑记录，最多 25 条。结果保留
nextCursor、total、appliedFilters、countryCoverage、availability、快照时间和各来源健康摘要。空字符串nextCursor表示没有更多页面。
min_automation_score。automationFit 仅是关键词相关性证据，绝不是代理或供应商可否投标的法律判断。participationMode: "unknown" 的含义不变——上游并未确定参与方式。