Primary Source Commodities

by sawftware-apps · remote · no sign-in to list tools · v0.1.0 · published by GitHub user sawftware-apps

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

Changes · 3

Compare Registry entry

11 tools: 3 change things and 8 only read.

Scanned Oct 21, 2026

Deletes or cancels0Claude Code: deny
Can't be undone0Claude Code: ask
Changes things3Claude Code: ask: see these tools
Only reads8Claude Code: allow: see these tools

3 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

3 warn

Warnprice.latest
The server marks "price.latest" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "return": a word for reading.
What this check looks for
Warnpositioning.get
The server marks "positioning.get" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "positioning.get" says "get": a word for reading.
What this check looks for
Warnprice.history
The server marks "price.history" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "return": a word for reading.
What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

11 tools

Changes things 3Creates or changes something that can be changed back.Claude Code: ask

positioning.getReturn the latest CFTC Commitments of Traders managed-money positioning for an instrument code.1 finding
Why it is in this group
- The name "positioning.get" says "get": a word for reading.
- The input takes a statement or command to run (input.code), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "positioning.get" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "positioning.get" says "get": a word for reading.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
price.historyReturn historical observations for an instrument code (up to 500 points).1 finding
Why it is in this group
- The description's first verb is "return": a word for reading.
- The input takes a statement or command to run (input.code), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "price.history" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "return": a word for reading.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
price.latestReturn the latest cash/fundies observation for one instrument code.1 finding
Why it is in this group
- The description's first verb is "return": a word for reading.
- The input takes a statement or command to run (input.code), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "price.latest" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "return": a word for reading.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false

Only reads 8Looks things up and changes nothing.Claude Code: allow

calendar.getList EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, and next-hint notes.No findings
Why it is in this group
- The name "calendar.get" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
catalog.listList every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata.No findings
Why it is in this group
- The name "catalog.list" says "list": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
decision.getBuild a deterministic decision pack for energy, metals, ags, or all sectors.No findings
Why it is in this group
- The name "decision.get" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
fundamentals.getFetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries.No findings
Why it is in this group
- The name "fundamentals.get" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
fx.latestReturn the latest FX rate observation for a pair or FRED FX series.No findings
Why it is in this group
- The description's first verb is "return": a word for reading.
Description, as the server wrote it
Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
inventory.getFetch EIA weekly petroleum inventory levels.No findings
Why it is in this group
- The name "inventory.get" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
snapshot.getBuild a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors.No findings
Why it is in this group
- The name "snapshot.get" says "snapshot": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
spread.getCompute 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).No findings
Why it is in this group
- The name "spread.get" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__commodities-sh__catalog_list",
      "mcp__commodities-sh__inventory_get",
      "mcp__commodities-sh__spread_get",
      "mcp__commodities-sh__fx_latest",
      "mcp__commodities-sh__fundamentals_get",
      "mcp__commodities-sh__snapshot_get",
      "mcp__commodities-sh__calendar_get",
      "mcp__commodities-sh__decision_get"
    ],
    "ask": [
      "mcp__commodities-sh__price_latest",
      "mcp__commodities-sh__positioning_get",
      "mcp__commodities-sh__price_history"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as commodities-sh. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.github.sawftware-apps/commodities-sh/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

3 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry. Synced Oct 21, 2026, 18:49 UTC.

For agents: Markdown · JSON · report this listing