Primary Source Commodities

io.github.sawftware-appsPublished by GitHub account sawftware-appsv0.1.0Updated Oct 24, 2026

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

The publisher's own server: Source

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Gives an assistant primary-source commodities data from EIA, FRED, CFTC, USDA and USGS through a remote endpoint.

What you can do
This server is a remote MCP endpoint that supplies commodities data drawn from primary sources: EIA, FRED, CFTC, USDA and USGS. The registry description says access is provided via x402 on Base. No individual tools are listed in the manifest, so the exact operations are not documented here.
When to use it
Consider it when an assistant needs commodities or economic data from official statistical sources rather than general web results. It is a remote service, so it suits setups that can reach an external endpoint.
Requirements
A remote MCP endpoint at api.commodities.sh over streamable HTTP. No packages, environment variables, headers or authentication are declared in the manifest. The description mentions x402 on Base, which implies a crypto payment or wallet arrangement, but no credentials are listed.
Before you install
The description mentions x402 on Base, which typically involves paying per request with a crypto wallet; treat any wallet key or payment credential as sensitive and expect possible spending. The manifest declares no authentication, so confirm how access and billing are actually handled before use. Data is fetched from a third-party endpoint.

Installation

In SourceWeft

  1. Open Primary Source Commodities in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.sawftware-apps%2Fcommodities-sh/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

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.

Takes no parameters.

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.

Parameterscoderequired

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.

Parametersseries

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.

Parameterscoderequired

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.

Parametersroottyperequired

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.

Parameterscoderequiredlimit

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.

Parameterspairrequired

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.

Parameterskindrequired

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.

Parameterssectorrequired

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.

Takes no parameters.

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.

Parameterssectorrequired

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Source integrations