MCP server

Primary Source Commodities

io.github.sawftware-apps/commodities-sh

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

11

Token cost

About 1,428 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.commodities-sh]
url = "https://api.commodities.sh/api/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add commodities-sh https://api.commodities.sh/api/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"commodities-sh","server_url":"https://api.commodities.sh/api/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"commodities-sh","server_url":"https://api.commodities.sh/api/mcp"}

Tools

• calendar.get ~89 tokens
  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.
• catalog.list ~99 tokens
  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.
• decision.get ~138 tokens
  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.
• fundamentals.get ~141 tokens
  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.
• fx.latest ~109 tokens
  Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
• inventory.get ~132 tokens
  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.
• positioning.get ~118 tokens
  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.
• price.history ~139 tokens
  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.
• price.latest ~127 tokens
  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.
• snapshot.get ~146 tokens
  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.
• spread.get ~190 tokens
  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.

Browse

• GitHub tools
• Calendars
• Booking and scheduling
• Payments
• GitHub and code hosting

Related MCP servers

• SiteCheck Trade & Energy
  112 pay-per-call agent tools: logistics, shipping, trade and energy data tools. x402
• Rootz Grocery
  Signed US food & grocery data: Kroger prices, nutrition, allergens, recalls, diet filters.
• LiveDataLink
  294 public-data tools across 60 domains; source freshness varies. Free tier.
• Magpie — USDA Ag Markets: Grain, Fertilizer, WASDE & Export Sales
  USDA farm data for AI agents: grain, fertilizer, WASDE, export sales. 27 tools, free, no key.
• Nass
  NASS MCP — USDA National Agricultural Statistics Service (Quick Stats)
• Theaslangroupllc Pulsenetwork
  914 paid market-data & token-safety endpoints — keyless x402 USDC: Base, Solana, XRPL, +8 chains
• USDA Food Access
  SNAP participation, food insecurity indicators, and agricultural statistics
• KeyVex
  US public financial disclosures for AI agents: Congress trades, SEC filings, FEC, lobbying, more

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.sawftware-apps/commodities-sh.svg)](https://aptlynx.net/servers/io.github.sawftware-apps/commodities-sh)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents