Search / io.github.sawftware-apps/commodities-sh
protogridR0· no sign-inPrimary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
v0.1.0 · active · descriptor JSON · versions
{
"mcpServers": {
"commodities-sh": {
"type": "http",
"url": "https://api.commodities.sh/api/mcp"
}
}
}claude mcp add --transport http commodities-sh https://api.commodities.sh/api/mcp[mcp_servers.commodities-sh]
url = "https://api.commodities.sh/api/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"commodities-sh": {
"type": "remote",
"url": "https://api.commodities.sh/api/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"commodities-sh": {
"type": "http",
"url": "https://api.commodities.sh/api/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=commodities-sh&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmNvbW1vZGl0aWVzLnNoL2FwaS9tY3AifQ%3D%3D"
}{
"servers": {
"commodities-sh": {
"type": "http",
"url": "https://api.commodities.sh/api/mcp"
}
}
}{
"mcpServers": {
"commodities-sh": {
"httpUrl": "https://api.commodities.sh/api/mcp"
}
}
}extensions:
"commodities-sh":
enabled: true
name: "commodities-sh"
type: streamable_http
uri: "https://api.commodities.sh/api/mcp"
timeout: 300
protocol.modernnewest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations11 of 11 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 1,368 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changesno tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+reachable +uptime-100% ~updated-85d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://api.commodities.sh/api/mcp streamable-http | none | yes | 100% | 332 ms | 2024-11-05 | 2026-10-19 |
calendar.getread-only | 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.listread-only | 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.getread-only | 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.getread-only | 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.latestread-only | Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies. |
inventory.getread-only | 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.getread-only | 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.historyread-only | 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.latestread-only | 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.getread-only | 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.getread-only | 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. |
Schemas: list_tools.
{
"name": "io.github.sawftware-apps/commodities-sh",
"title": "Primary Source Commodities",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://api.commodities.sh/api/mcp",
"type": "streamable-http"
}
],
"version": "0.1.0",
"description": "Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base."
}