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 整合