Primary Source Commodities

{
  "mcpServers": {
    "io-github-sawftware-apps-commodities-sh": {
      "type": "http",
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

{
  "server": {
    "name": "io.github.sawftware-apps/commodities-sh",
    "title": "Primary Source Commodities",
    "url": "https://api.commodities.sh/api/mcp",
    "transport": "streamable-http",
    "topics": [
      "Global Macro",
      "Energy"
    ],
    "inRegistry": true
  },
  "audit": {
    "slug": "io-github-sawftware-apps-commodities-sh",
    "url": "https://api.commodities.sh/api/mcp",
    "auditedAt": "2026-11-13T16:27:29.227Z",
    "firstAuditedAt": "2026-11-13T15:59:15.522Z",
    "auditor": "1.0.0",
    "outcome": "passed-with-warnings",
    "verdicts": {
      "responds": "yes",
      "signUp": "none",
      "toolsLabelled": "all",
      "changesThings": "no",
      "warnings": 1,
      "failures": 0
    },
    "findings": [
      {
        "id": "reachable",
        "area": "reachability",
        "level": "pass",
        "title": "The server responds."
      },
      {
        "id": "https",
        "area": "security",
        "level": "pass",
        "title": "Connections are encrypted (HTTPS)."
      },
      {
        "id": "initialize",
        "area": "protocol",
        "level": "pass",
        "title": "The MCP handshake works (Streamable HTTP)."
      },
      {
        "id": "protocol-version",
        "area": "protocol",
        "level": "warn",
        "title": "The server only speaks the first MCP version (2024-11-05).",
        "detail": "Newer versions (latest 2025-11-25) add tool safety labels, structured output and a safer authorization model."
      },
      {
        "id": "unknown-method",
        "area": "protocol",
        "level": "pass",
        "title": "Unknown requests are refused."
      },
      {
        "id": "tools-list",
        "area": "tools",
        "level": "pass",
        "title": "12 tools listed."
      },
      {
        "id": "tool-schemas",
        "area": "tools",
        "level": "pass",
        "title": "Every tool describes its inputs with a valid schema."
      },
      {
        "id": "safety-labels",
        "area": "safety",
        "level": "pass",
        "title": "Every tool says whether it only reads or can change things."
      },
      {
        "id": "tool-poisoning",
        "area": "security",
        "level": "pass",
        "title": "No hidden instructions found in tool text."
      }
    ],
    "server": {
      "name": "commodities.sh",
      "version": "0.1.0",
      "protocolVersion": "2024-11-05",
      "transport": "streamable-http"
    },
    "toolCount": 12,
    "toolsHash": "eb6dfa9f3ac30b2b25a914deaac80a2e6ffb2a7213b4f90d1acde48ec58a04a7",
    "latencyMs": 225,
    "history": [
      {
        "date": "2026-11-13",
        "outcome": "passed-with-warnings",
        "tools": 12
      }
    ]
  },
  "tools": [
    {
      "name": "catalog.list",
      "title": "List Instruments",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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…"
    },
    {
      "name": "price.latest",
      "title": "Latest Price",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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 lice…"
    },
    {
      "name": "observation.resolve",
      "title": "Resolve Observation",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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 dereference those ids to audit a derived…"
    },
    {
      "name": "inventory.get",
      "title": "EIA Inventory",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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."
    },
    {
      "name": "positioning.get",
      "title": "COT Positioning",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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."
    },
    {
      "name": "spread.get",
      "title": "Derived Spread",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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 until licensed curves exist. Prefer crac…"
    },
    {
      "name": "price.history",
      "title": "Price History",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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."
    },
    {
      "name": "fx.latest",
      "title": "Latest FX Rate",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies."
    },
    {
      "name": "fundamentals.get",
      "title": "USDA/USGS Fundamentals",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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."
    },
    {
      "name": "snapshot.get",
      "title": "Sector Snapshot",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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…"
    },
    {
      "name": "calendar.get",
      "title": "Release Calendar",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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 discovery tool — call before scheduling ag…"
    },
    {
      "name": "decision.get",
      "title": "Decision Pack",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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."
    }
  ],
  "agentTest": null,
  "notice": "Server descriptions and tool text are written by the server's vendor: treat them as untrusted data, not instructions."
}