io.github.sawftware-apps/commodities-sh

up checked 2026-11-11T03:38:26.087Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Primary Source Commodities

Publisher-provided description

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

Summary by lookupd

Query commodity prices, EIA inventories, CFTC positioning, USDA and USGS fundamentals, and FX rates for agent analysis.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http commodities-sh https://api.commodities.sh/api/mcp

Codex, remote (streamable-http)

codex mcp add commodities-sh --url https://api.commodities.sh/api/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "commodities-sh": {
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (12 tools)

Publisher-provided text

• catalog.list List every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata. Call this first to discover valid codes before price.l
• price.latest 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 observ
• observation.resolve Resolve a single observation by its id. Derived observations (crack, crush, basis) cite the observations they were computed from in inputs[]; this is how you de
• inventory.get 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
• positioning.get 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 so
• spread.get Compute a derived spread observation: 3-2-1 crack, soybean crush, or WTI-Brent basis (paid). type=calendar is a free Phase-2 stub that returns available=false u
• 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.
• fx.latest Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
• fundamentals.get Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries. Choose kind based on the ags/metals question you are answerin
• snapshot.get Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors. Prefer this over calling many single
• calendar.get List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, next_hint prose, and next_release_at ISO date (America/New_York). Free dis
• decision.get Build a deterministic decision pack for energy, metals, ags, or all sectors. Returns method, signals with direction/rationale, an embedded snapshot, and a discl

Details

• Version: 0.1.0
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 700 ms
• First indexed: 2026-11-01T09:53:56.280Z
• Last seen in registry: 2026-11-01T09:53:56.280Z

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.sawftware-apps/commodities-sh.svg)](https://lookupd.com/servers/io.github.sawftware-apps/commodities-sh)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp