Primary Source Commodities

io.github.sawftware-apps由 GitHub 账号 sawftware-apps 发布v0.1.0更新于 Oct 24, 2026

Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.

发布方自己的服务:Source

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

让助手通过远程端点获取 EIA、FRED、CFTC、USDA 和 USGS 的一手大宗商品数据。

可以做什么
该服务器是一个远程 MCP 端点,提供来自一手来源的大宗商品数据:EIA、FRED、CFTC、USDA 和 USGS。注册表描述称通过 Base 上的 x402 提供访问。清单中未列出具体工具,因此这里无法说明确切的可用操作。
适用场景
当助手需要来自官方统计来源的大宗商品或经济数据,而不是普通网页搜索结果时,可以考虑使用。它是远程服务,适合能够访问外部端点的环境。
运行要求
通过 streamable HTTP 访问 api.commodities.sh 的远程 MCP 端点。清单未声明任何软件包、环境变量、请求头或身份验证。描述提到 Base 上的 x402,意味着可能涉及加密货币支付或钱包安排,但未列出任何凭据。
安装前请注意
描述提到 Base 上的 x402,通常意味着用加密钱包按请求付费;请将任何钱包密钥或支付凭据视为敏感信息,并预期可能产生费用。清单未声明身份验证,使用前请确认访问与计费的实际方式。数据来自第三方端点。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Primary Source Commodities,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.sawftware-apps%2Fcommodities-sh/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "primary-source-commodities": {
      "type": "http",
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

工具

11

catalog.list

List Instruments

List every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata. Call this first to discover valid codes before price.latest or inventory.get. Free discovery tool — no payment required.

无需输入参数。

price.latest

Latest Price

Return the latest cash/fundies observation for one instrument code. Use catalog.list to discover codes such as CL, GC, or ZC. Response follows the shared observation contract with provenance and license tags.

输入参数code必填

inventory.get

EIA Inventory

Fetch EIA weekly petroleum inventory levels. Omit series to list all latest inventory points, or pass a series key to get week-over-week change, vs-5y deviation, and a surprise label for that series.

输入参数series

positioning.get

COT Positioning

Return the latest CFTC Commitments of Traders managed-money positioning for an instrument code. Includes long, short, net, and week-over-week net change with source URL.

输入参数code必填

spread.get

Derived Spread

Compute a derived spread observation: 3-2-1 crack, soybean crush, WTI-Brent basis, or calendar (calendar requires licensed curve data and may return available=false). Prefer crack/crush/basis for live derived values with formula and inputs.

输入参数roottype必填

price.history

Price History

Return historical observations for an instrument code (up to 500 points). Use after price.latest when you need a short time series for the same code.

输入参数code必填limit

fx.latest

Latest FX Rate

Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.

输入参数pair必填

fundamentals.get

USDA/USGS Fundamentals

Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries. Choose kind based on the ags/metals question you are answering.

输入参数kind必填

snapshot.get

Sector Snapshot

Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors. Prefer this over calling many single-observation tools when you need a full sector picture.

输入参数sector必填

calendar.get

Release Calendar

List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, and next-hint notes. Free discovery tool — call before scheduling agents around inventory or WASDE prints.

无需输入参数。

decision.get

Decision Pack

Build a deterministic decision pack for energy, metals, ags, or all sectors. Returns method, signals with direction/rationale, an embedded snapshot, and a disclaimer — no ML model, rule-based only.

输入参数sector必填

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。

其他 Source 集成