{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "api.commodities.sh",
    "site": "commodities.sh",
    "addresses": [
      {
        "address": "216.150.1.193",
        "endpoints": 699,
        "shared_infrastructure": true,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "216.150.1.0/24",
          "country": "US"
        }
      },
      {
        "address": "216.150.16.193",
        "endpoints": 686,
        "shared_infrastructure": true,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "216.150.16.0/24",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "216.150.1.193",
          "216.150.16.193"
        ],
        "first_seen": "2026-11-21T17:00:01.917Z",
        "last_seen": "2026-11-21T17:00:01.917Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Vercel",
        "evidence": "Server header \"Vercel\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "commodities.sh",
      "version": "0.1.0",
      "protocol_version": "2024-11-05"
    },
    "headers": {
      "server": "Vercel",
      "strict-transport-security": "max-age=63072000",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 901,
      "sample": [
        {
          "id": "38",
          "url": "https://www.hood.ag/api/mcp",
          "server_name": "ag.hood/name-service",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:32:01.495Z"
        },
        {
          "id": "39",
          "url": "https://www.almostimpossible.agency/mcp",
          "server_name": "agency.almostimpossible/site",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:32:01.495Z"
        },
        {
          "id": "182",
          "url": "https://www.ai-portal.ai/mcp",
          "server_name": "ai.ai-portal/ai-portal",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:34:01.210Z"
        },
        {
          "id": "248",
          "url": "https://app.aqta.ai/api/mcp",
          "server_name": "ai.aqta/seal",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:35:03.039Z"
        },
        {
          "id": "278",
          "url": "https://asrm.ai/mcp",
          "server_name": "ai.asrm/asrm",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:37:01.449Z"
        },
        {
          "id": "368",
          "url": "https://beexcellent.ai/api/mcp/public",
          "server_name": "ai.beexcellent/reference",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:39:02.648Z"
        },
        {
          "id": "395",
          "url": "https://property.bluebed.ai/mcp",
          "server_name": "ai.bluebed.property/new-launches",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:40:02.123Z"
        },
        {
          "id": "416",
          "url": "https://www.bordet.ai/api/mcp/mcp",
          "server_name": "ai.bordet/bordet",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:39:02.482Z"
        },
        {
          "id": "430",
          "url": "https://www.budgetseo.ai/api/mcp",
          "server_name": "ai.budgetseo/budget-seo-mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:00.965Z"
        },
        {
          "id": "461",
          "url": "https://callmcp.ai/mcp",
          "server_name": "ai.callmcp/server",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:01.824Z"
        },
        {
          "id": "670",
          "url": "https://www.decisionlog.ai/api/mcp",
          "server_name": "ai.decisionlog/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:45:03.762Z"
        },
        {
          "id": "754",
          "url": "https://www.edgechat.ai/mcp",
          "server_name": "ai.edgechat/edgepedia",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:48:01.794Z"
        },
        {
          "id": "787",
          "url": "https://mcp.tenda.eshmere.ai/mcp",
          "server_name": "ai.eshmere/tenda",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:50:01.774Z"
        },
        {
          "id": "868",
          "url": "https://www.flamel.ai/mcp",
          "server_name": "ai.flamel/public-content",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:51:02.819Z"
        },
        {
          "id": "908",
          "url": "https://mcp.fudge.ai/mcp",
          "server_name": "ai.fudge/fudge",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:52:01.102Z"
        },
        {
          "id": "1083",
          "url": "https://govrelations.ai/mcp",
          "server_name": "ai.govrelations/govrelations",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:54:00.852Z"
        },
        {
          "id": "1134",
          "url": "https://www.heycai.ai/mcp",
          "server_name": "ai.heycai/clinic-tools",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:55:02.831Z"
        },
        {
          "id": "1183",
          "url": "https://hustlin.ai/api/mcp",
          "server_name": "ai.hustlin/hustlin",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:56:01.796Z"
        },
        {
          "id": "1300",
          "url": "https://kifly.ai/api/mcp",
          "server_name": "ai.kifly/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:59:02.560Z"
        },
        {
          "id": "1563",
          "url": "https://www.modulos.ai/mcp/",
          "server_name": "ai.modulos/demo-booking",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:43:08.809Z"
        }
      ]
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.github.sawftware-apps",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/sawftware-apps/commodities",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "39011",
    "server_name": "io.github.sawftware-apps/commodities-sh",
    "url": "https://api.commodities.sh/api/mcp",
    "host": "api.commodities.sh",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T17:00:01.917Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "bbc4e36328a31a68eefee2186133e5c85bb2768ab8f92ced8d3475e7e58dfb7b",
    "first_listed_at": "2026-11-21T17:00:01.917Z",
    "created_at": "2026-11-21T11:50:04.009Z",
    "resolved_addresses": [
      "216.150.1.193",
      "216.150.16.193"
    ]
  },
  "server": {
    "name": "io.github.sawftware-apps/commodities-sh",
    "title": "Primary Source Commodities",
    "description": "Primary-source commodities for agents — EIA, USDA, CFTC, IMF, USGS, FAOSTAT, Comtrade. 30 tools.",
    "version": "0.2.0",
    "registry_status": "active",
    "repository_url": "https://github.com/sawftware-apps/commodities",
    "website_url": null,
    "published_at": "2026-11-15T12:59:10.035Z",
    "updated_at": "2026-11-15T12:59:10.035Z",
    "first_seen": "2026-11-21T11:50:03.494Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "x402"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:49:09.161Z"
  },
  "operator": {
    "key": "commodities.sh",
    "name": "commodities.sh",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 415,
    "first_check_in_window": "2026-11-21T17:00:01.917Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "bbc4e36328a31a68eefee2186133e5c85bb2768ab8f92ced8d3475e7e58dfb7b",
    "tools": 30,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-21T17:00:02.340Z",
    "tool_names": [
      "catalog.list",
      "catalog.search",
      "price.latest",
      "price.stats",
      "trade.calculate",
      "trade.flow",
      "sourcing.compare",
      "producer.prices",
      "trade.partners",
      "trade.ranking",
      "observation.resolve",
      "inventory.get",
      "positioning.get",
      "spread.get",
      "price.history",
      "fx.latest",
      "fundamentals.get",
      "snapshot.get",
      "calendar.get",
      "trade.codes",
      "minerals.list",
      "cash.reports",
      "price.bundle",
      "stats.bundle",
      "producer.prices.bundle",
      "account.quota",
      "minerals.dossier",
      "cash.bids",
      "releases.next",
      "decision.get"
    ],
    "declared": {
      "tools": [
        {
          "name": "catalog.list",
          "title": "List Instruments",
          "description": "FREE. 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.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "instruments"
            ],
            "properties": {
              "instruments": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "code",
                    "name",
                    "sector",
                    "unit",
                    "primary_series_id",
                    "primary_source",
                    "freshness_class",
                    "license_tag",
                    "available"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Instrument code, e.g. CL"
                    },
                    "name": {
                      "type": "string",
                      "description": "Display name"
                    },
                    "unit": {
                      "type": "string",
                      "description": "Unit of measure"
                    },
                    "venue": {
                      "type": "string",
                      "description": "Trading venue when known"
                    },
                    "sector": {
                      "enum": [
                        "energy",
                        "metals",
                        "ags",
                        "fx"
                      ],
                      "type": "string",
                      "description": "Sector grouping"
                    },
                    "available": {
                      "type": "boolean",
                      "description": "False when the code is registered but has no resolvable source, so price.latest can only 404"
                    },
                    "license_tag": {
                      "type": "string",
                      "description": "License / redistribution tag"
                    },
                    "primary_source": {
                      "type": "string",
                      "description": "Primary source name, e.g. EIA or FRED"
                    },
                    "freshness_class": {
                      "type": "string",
                      "description": "Expected freshness class"
                    },
                    "primary_series_id": {
                      "type": "string",
                      "description": "Primary source series id"
                    },
                    "cot_commodity_hint": {
                      "type": "string",
                      "description": "CFTC commodity hint when applicable"
                    }
                  }
                },
                "description": "Instrument registry rows"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "catalog.search",
          "title": "Search Instruments",
          "description": "FREE. Resolve a human commodity name to an instrument code — 'cocoa' to CC, 'copper' to HG, 'palm oil' to PO. Use this instead of catalog.list when you already know the commodity by name and need the code to call price.latest or trade.flow. Returns nothing rather than a guess when no instrument matches. Free discovery tool — no payment required.",
          "inputSchema": {
            "type": "object",
            "required": [
              "q"
            ],
            "properties": {
              "q": {
                "type": "string",
                "description": "Commodity name, synonym, or instrument code, e.g. 'cocoa'"
              },
              "limit": {
                "type": "integer",
                "description": "Maximum results (1-50, default 10)"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "query",
              "results"
            ],
            "properties": {
              "query": {
                "type": "string",
                "description": "The query as interpreted"
              },
              "results": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "code",
                    "name",
                    "sector",
                    "unit",
                    "available",
                    "match",
                    "matched_on"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Instrument code to use in other tools"
                    },
                    "name": {
                      "type": "string",
                      "description": "Display name"
                    },
                    "unit": {
                      "type": "string",
                      "description": "Unit of measure"
                    },
                    "match": {
                      "enum": [
                        "code",
                        "synonym",
                        "name",
                        "partial"
                      ],
                      "type": "string",
                      "description": "Why this row matched. 'code' and 'synonym' are exact and safe to act on; 'name' and 'partial' are substring suggestions worth confirming."
                    },
                    "sector": {
                      "enum": [
                        "energy",
                        "metals",
                        "ags",
                        "fx"
                      ],
                      "type": "string",
                      "description": "Sector grouping"
                    },
                    "available": {
                      "type": "boolean",
                      "description": "False when the instrument has no resolvable source and price.latest can only fail"
                    },
                    "matched_on": {
                      "type": "string",
                      "description": "The registry string the query hit"
                    }
                  }
                },
                "description": "Matching instruments, most confident first"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "price.latest",
          "title": "Latest Price",
          "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 license tags.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Instrument code from catalog.list. Example: CL, GC, ZC."
              },
              "currency": {
                "type": "string",
                "description": "Optional ISO currency to additionally express the price in, e.g. BRL. The observation itself stays in its catalog unit and remains the citable value; a `converted` block is added alongside it, citing the rate and its own as_of."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "instrument",
              "name",
              "value",
              "unit",
              "as_of",
              "observed_at",
              "freshness_class",
              "quality",
              "derived",
              "source",
              "license_tag",
              "provenance",
              "series_id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable observation id"
              },
              "cite": {
                "type": "string",
                "description": "One-line citation for agents"
              },
              "name": {
                "type": "string",
                "description": "Human-readable instrument name"
              },
              "unit": {
                "type": "string",
                "description": "Unit of measure"
              },
              "as_of": {
                "type": "string",
                "description": "As-of date for the observation"
              },
              "prior": {
                "type": "number",
                "description": "Previous print value when history exists"
              },
              "value": {
                "type": "number",
                "description": "Observed numeric value"
              },
              "inputs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Input series ids when derived"
              },
              "source": {
                "type": "object",
                "required": [
                  "name",
                  "series_id",
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "series_id": {
                    "type": "string"
                  }
                },
                "description": "Primary source provenance"
              },
              "derived": {
                "type": "boolean",
                "description": "True when value is derived"
              },
              "formula": {
                "type": "string",
                "description": "Derivation formula when derived"
              },
              "quality": {
                "type": "string",
                "description": "Data quality label"
              },
              "raw_hash": {
                "type": "string",
                "description": "Hash of raw source payload"
              },
              "series_id": {
                "type": "string",
                "description": "Underlying series id"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code, e.g. CL"
              },
              "pct_change": {
                "type": "number",
                "description": "Percent change vs prior print"
              },
              "provenance": {
                "type": "object",
                "required": [
                  "retrieved_at",
                  "cache_hit",
                  "cache_ttl_s"
                ],
                "properties": {
                  "cache_hit": {
                    "type": "boolean"
                  },
                  "cache_ttl_s": {
                    "type": "number"
                  },
                  "retrieved_at": {
                    "type": "string"
                  }
                },
                "description": "Retrieval / cache provenance"
              },
              "license_tag": {
                "type": "string",
                "description": "License / redistribution tag"
              },
              "observed_at": {
                "type": "string",
                "description": "ISO timestamp when observed"
              },
              "short_history": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "as_of": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    }
                  }
                },
                "description": "Newest-first short history (≤8 points)"
              },
              "freshness_class": {
                "type": "string",
                "description": "Freshness class for the series"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "price.stats",
          "title": "Price Statistics",
          "description": "Realized volatility, change over window, and range for an instrument, computed over its stored history. Use this for 'how volatile is X' and 'how has X moved over the last year' — it answers both in one call, so prefer it over fetching price.history and computing yourself. Descriptive only: no signals or view, which live in decision.get.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Instrument code from catalog.list. Example: CC, CL, GC."
              },
              "windows": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Windows to compute over, as a count and a unit. Example: [\"30d\", \"90d\", \"1y\"]. Defaults to those three."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "instrument",
              "series_id",
              "volatility",
              "change",
              "range",
              "input_series"
            ],
            "properties": {
              "unit": {
                "type": "string",
                "description": "Unit of the underlying price"
              },
              "as_of": {
                "type": "string",
                "description": "Economic date of the newest observation used"
              },
              "range": {
                "type": "object",
                "required": [
                  "min",
                  "max",
                  "mean"
                ],
                "properties": {
                  "max": {
                    "type": "number"
                  },
                  "min": {
                    "type": "number"
                  },
                  "mean": {
                    "type": "number"
                  }
                },
                "description": "Min, max and mean over the retained history"
              },
              "change": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "window",
                    "from",
                    "to",
                    "from_as_of",
                    "to_as_of"
                  ],
                  "properties": {
                    "to": {
                      "type": "number"
                    },
                    "pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "from": {
                      "type": "number"
                    },
                    "window": {
                      "type": "string"
                    },
                    "to_as_of": {
                      "type": "string"
                    },
                    "from_as_of": {
                      "type": "string"
                    }
                  }
                },
                "description": "Change across each window, both endpoints dated"
              },
              "series_id": {
                "type": "string",
                "description": "Underlying series id"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code"
              },
              "volatility": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "window",
                    "n",
                    "annualized_pct",
                    "sufficient"
                  ],
                  "properties": {
                    "n": {
                      "type": "number",
                      "description": "Number of returns used"
                    },
                    "method": {
                      "type": "string"
                    },
                    "reason": {
                      "type": "string",
                      "description": "Why no figure, when insufficient"
                    },
                    "window": {
                      "type": "string"
                    },
                    "sufficient": {
                      "type": "boolean"
                    },
                    "annualized_pct": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Null when the window cannot support a figure"
                    }
                  }
                },
                "description": "Annualized realized volatility per window"
              },
              "license_tag": {
                "type": "string",
                "description": "Licence the derived figures may claim"
              },
              "input_series": {
                "type": "object",
                "required": [
                  "series_id",
                  "from",
                  "to",
                  "n"
                ],
                "properties": {
                  "n": {
                    "type": "number"
                  },
                  "to": {
                    "type": "string"
                  },
                  "from": {
                    "type": "string"
                  },
                  "series_id": {
                    "type": "string"
                  }
                },
                "description": "The window these figures were computed over. Dereference via price.history for the observations themselves."
              },
              "periods_per_year": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Observations per year implied by the series cadence; null when the cadence makes no promise and nothing can be annualized"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "trade.calculate",
          "title": "Trade Calculation",
          "description": "Deterministic trade arithmetic over numbers you supply: landed cost, trade margin, break-even price, or the effect of a USD move. Nothing is sourced — there is no free source for duty rates, freight or insurance, so an input you omit is excluded from the total and reported in `missing`, never defaulted to zero. Use price.latest first if you want a benchmark price to pass as unit_price.",
          "inputSchema": {
            "type": "object",
            "required": [
              "calculation"
            ],
            "properties": {
              "amount": {
                "type": "number",
                "description": "fx_impact: amount held in the foreign currency."
              },
              "fx_rate": {
                "type": "number",
                "description": "landed_cost: units of quote_currency per USD. fx_impact: the rate to shock."
              },
              "incoterm": {
                "enum": [
                  "EXW",
                  "FOB",
                  "CFR",
                  "CIF"
                ],
                "type": "string",
                "description": "landed_cost: decides which costs your price already carries, so it shapes `missing`. CIF already includes freight and insurance. Example: CIF."
              },
              "port_usd": {
                "type": "number",
                "description": "landed_cost: port charges."
              },
              "quantity": {
                "type": "number",
                "description": "Quantity. Example: 100."
              },
              "buy_price": {
                "type": "number",
                "description": "trade_margin, break_even: purchase price per unit."
              },
              "costs_usd": {
                "type": "number",
                "description": "trade_margin, break_even: other costs."
              },
              "rate_unit": {
                "type": "string",
                "description": "fx_impact: direction of fx_rate, read not inferred. Example: GHS/USD means cedi per dollar."
              },
              "price_unit": {
                "type": "string",
                "description": "landed_cost: unit of unit_price. Example: USD/metric ton."
              },
              "sell_price": {
                "type": "number",
                "description": "trade_margin: sale price per unit."
              },
              "unit_price": {
                "type": "number",
                "description": "landed_cost: price per unit. Example: 1133.13."
              },
              "calculation": {
                "enum": [
                  "landed_cost",
                  "trade_margin",
                  "break_even",
                  "fx_impact"
                ],
                "type": "string",
                "description": "Which calculation to run. Example: landed_cost."
              },
              "freight_usd": {
                "type": "number",
                "description": "landed_cost: your freight cost. Omit and it is reported missing, not assumed zero."
              },
              "handling_usd": {
                "type": "number",
                "description": "landed_cost: handling charges."
              },
              "usd_move_pct": {
                "type": "number",
                "description": "fx_impact: percent the USD strengthens. Example: 5."
              },
              "duty_rate_pct": {
                "type": "number",
                "description": "landed_cost: your import duty rate, percent. Example: 8."
              },
              "insurance_usd": {
                "type": "number",
                "description": "landed_cost: your insurance cost."
              },
              "quantity_unit": {
                "type": "string",
                "description": "landed_cost: unit of quantity. Example: metric ton."
              },
              "quote_currency": {
                "type": "string",
                "description": "landed_cost: currency for the total. Needs fx_rate — no rate is sourced. Example: GHS."
              }
            },
            "additionalProperties": true
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "calculation",
              "value",
              "unit",
              "components",
              "missing",
              "partial"
            ],
            "properties": {
              "unit": {
                "type": "string",
                "description": "Unit of the result"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Caveats, including unmodelled distinctions"
              },
              "value": {
                "type": "number",
                "description": "The result"
              },
              "formula": {
                "type": "string",
                "description": "How it was computed"
              },
              "missing": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Inputs not supplied. Their components are excluded from the total, not defaulted."
              },
              "partial": {
                "type": "boolean",
                "description": "True when anything is missing"
              },
              "components": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "label",
                    "amount",
                    "source"
                  ],
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "number"
                    },
                    "source": {
                      "type": "string",
                      "description": "caller_supplied, or observation:<id>"
                    },
                    "formula": {
                      "type": "string"
                    }
                  }
                },
                "description": "Each part of the build-up, with where its number came from"
              },
              "disclaimer": {
                "type": "string"
              },
              "assumptions": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Caller-supplied inputs, echoed"
              },
              "calculation": {
                "type": "string",
                "description": "Which calculation ran"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "trade.flow",
          "title": "Bilateral Trade Flow",
          "description": "Import or export volume and value between two countries for one commodity and year, from UN Comtrade. Use for 'how much X did A sell to B'. Pass countries as ISO alpha-3 (IND, GHA) and partner=WLD for the world total. Call trade.codes-equivalent discovery via /v1/trade/codes for valid values. Annual data; the response says whether the rows reconcile with the upstream's own total.",
          "inputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "reporter",
              "year"
            ],
            "properties": {
              "flow": {
                "enum": [
                  "import",
                  "export"
                ],
                "type": "string",
                "description": "Direction from the reporter's view. Example: export."
              },
              "year": {
                "type": "number",
                "description": "Four-digit year. Example: 2023."
              },
              "partner": {
                "type": "string",
                "description": "Partner country, or WLD for the world total. Example: GHA."
              },
              "reporter": {
                "type": "string",
                "description": "Reporting country, ISO alpha-3 preferred. Example: IND."
              },
              "commodity": {
                "type": "string",
                "description": "Instrument code with an HS heading. Example: ZR for rice."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "reporter",
              "partner",
              "year",
              "found"
            ],
            "properties": {
              "flow": {
                "type": "string"
              },
              "year": {
                "type": "number"
              },
              "found": {
                "type": "boolean",
                "description": "False when the upstream has no data for this cell"
              },
              "source": {
                "type": "object",
                "description": "series_id is the canonical query; url re-runs it"
              },
              "hs_code": {
                "type": "string",
                "description": "Harmonised System heading queried"
              },
              "partner": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "number"
                  },
                  "name": {
                    "type": "string"
                  }
                }
              },
              "complete": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Whether returned rows reconcile with the upstream's World total; null when there is nothing to compare"
              },
              "reporter": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "number"
                  },
                  "name": {
                    "type": "string"
                  }
                }
              },
              "commodity": {
                "type": "string"
              },
              "license_tag": {
                "type": "string"
              },
              "net_weight_kg": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "shortfall_usd": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "primary_value_usd": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "sourcing.compare",
          "title": "Compare Sourcing Countries",
          "description": "For one commodity and year, compare countries as a source: what the grower was paid (FAOSTAT farm gate) against what it left the country for (UN Comtrade export unit value), plus the share reaching the grower. Ranked cheapest first on a named observable field — there is NO opportunity score, because the weights would be invented. Supply freight_usd / duty_rate_pct to add a landed cost; absent costs are never defaulted, they are listed in `missing`. Annual data: this supports structural comparison, not an arbitrage claim. Covers the seven crops FAOSTAT prices.",
          "inputSchema": {
            "type": "object",
            "required": [
              "commodity"
            ],
            "properties": {
              "year": {
                "type": "number",
                "description": "Four-digit year; defaults to the latest available."
              },
              "currency": {
                "type": "string",
                "description": "Optional ISO currency for an additional converted view."
              },
              "incoterm": {
                "enum": [
                  "EXW",
                  "FOB",
                  "CFR",
                  "CIF"
                ],
                "type": "string"
              },
              "port_usd": {
                "type": "number"
              },
              "commodity": {
                "enum": [
                  "ZC",
                  "ZW",
                  "ZS",
                  "ZR",
                  "KC",
                  "CC",
                  "CT"
                ],
                "type": "string",
                "description": "Instrument code. Example: CC for cocoa."
              },
              "freight_usd": {
                "type": "number",
                "description": "Caller-supplied freight per tonne."
              },
              "handling_usd": {
                "type": "number"
              },
              "duty_rate_pct": {
                "type": "number",
                "description": "Caller-supplied duty rate, percent."
              },
              "insurance_usd": {
                "type": "number"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "year",
              "countries",
              "available",
              "notes"
            ],
            "properties": {
              "year": {
                "type": "number"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Read before presenting any figure from this tool."
              },
              "missing": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Cost fields not supplied, hence excluded"
              },
              "partial": {
                "type": "boolean"
              },
              "available": {
                "type": "boolean",
                "description": "False when fewer than two countries could be compared. Served free in that case."
              },
              "commodity": {
                "type": "string"
              },
              "countries": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "reason": {
                      "type": "string",
                      "description": "Why a row is incomplete, when it is"
                    },
                    "country": {
                      "type": "object",
                      "properties": {
                        "m49": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      }
                    },
                    "sufficient": {
                      "type": "boolean"
                    },
                    "far_from_peers": {
                      "type": "boolean",
                      "description": "Outside the peer band either way. Worth a look, not a verdict."
                    },
                    "farm_share_pct": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Farm gate over export unit value. A supply-chain signal, not a margin anyone earned."
                    },
                    "vs_peer_median_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "farm_gate_usd_per_tonne": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "landed_cost_usd_per_tonne": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "export_unit_value_usd_per_tonne": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  }
                },
                "description": "Cheapest first on the ranked field"
              },
              "ranked_by": {
                "type": "string",
                "description": "The observable field the list is sorted by"
              },
              "license_tag": {
                "type": "string"
              },
              "unavailable": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "reason": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    }
                  }
                },
                "description": "Sources that could not contribute, each with the reason"
              },
              "sources_used": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "years_available": {
                "type": "array",
                "items": {
                  "type": "number"
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "producer.prices",
          "title": "Producer Prices by Country",
          "description": "Farm-gate producer prices by country for one commodity and year, from FAOSTAT. Use for 'where is this cheap at source' and for comparing what growers are actually paid across countries. THIS IS NOT A BENCHMARK: a producer price is what the farmer received, and differs from price.latest and from the export unit value in trade.partners — all three can be correct and several-fold apart. Covers seven crops only (ZC ZW ZS ZR KC CC CT); sugar, palm and livestock are deliberately unmapped because FAOSTAT prices a different product for those. Annual, usually one to two years behind.",
          "inputSchema": {
            "type": "object",
            "required": [
              "commodity"
            ],
            "properties": {
              "year": {
                "type": "number",
                "description": "Four-digit year; defaults to the latest available."
              },
              "commodity": {
                "enum": [
                  "ZC",
                  "ZW",
                  "ZS",
                  "ZR",
                  "KC",
                  "CC",
                  "CT"
                ],
                "type": "string",
                "description": "Instrument code. Example: KC for coffee."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "year",
              "countries",
              "notes"
            ],
            "properties": {
              "year": {
                "type": "number"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Read before presenting any figure from this tool."
              },
              "source": {
                "type": "object"
              },
              "commodity": {
                "type": "string"
              },
              "countries": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "m49": {
                      "type": "string",
                      "description": "M49 code — joins to trade.flow country codes"
                    },
                    "area": {
                      "type": "string"
                    },
                    "flag": {
                      "type": "string",
                      "description": "FAO flag: A official, E estimated, I imputed, X external"
                    },
                    "vs_median": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Multiple of the peer median"
                    },
                    "catalog_unit": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "usd_per_tonne": {
                      "type": "number"
                    },
                    "far_from_peers": {
                      "type": "boolean",
                      "description": "Outside the peer band, either direction. Means 'worth a second look', NOT 'bad data' — the band catches both micro specialty crops and genuinely cheap large producers. Do not discard rows on this flag."
                    },
                    "usd_per_catalog_unit": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The same figure in the instrument's own unit, null where no honest mass conversion exists"
                    }
                  }
                },
                "description": "Countries, cheapest first"
              },
              "license_tag": {
                "type": "string"
              },
              "faostat_item": {
                "type": "string",
                "description": "The FAOSTAT item actually priced"
              },
              "country_count": {
                "type": "number"
              },
              "years_available": {
                "type": "array",
                "items": {
                  "type": "number"
                }
              },
              "peer_band_multiple": {
                "type": "number",
                "description": "The multiple of the median beyond which far_from_peers is set"
              },
              "vs_median_available": {
                "type": "boolean",
                "description": "False when too few countries report for a median to mean anything"
              },
              "peer_median_usd_per_tonne": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "trade.partners",
          "title": "Trading Partners Ranked",
          "description": "Every country one reporter traded a commodity with in a year, ranked by value, each with the implied unit value it paid or received. Use for 'where does Ghana sell its cocoa and at what price to each buyer' and for comparing prices across markets. Pass the reporter as ISO alpha-3 (GHA, IND). Annual data. Completeness is verifiable for this shape: the response says whether the partner rows reconcile with the upstream's own World total.",
          "inputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "reporter",
              "year"
            ],
            "properties": {
              "flow": {
                "enum": [
                  "import",
                  "export"
                ],
                "type": "string",
                "description": "Direction from the reporter's view."
              },
              "year": {
                "type": "number",
                "description": "Four-digit year. Example: 2023."
              },
              "limit": {
                "type": "number",
                "description": "Maximum rows returned, 1-200 (default 25)."
              },
              "reporter": {
                "type": "string",
                "description": "Reporting country, ISO alpha-3 preferred. Example: GHA."
              },
              "commodity": {
                "type": "string",
                "description": "Instrument code with an HS heading. Example: CC for cocoa."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "reporter",
              "year",
              "partners",
              "notes"
            ],
            "properties": {
              "flow": {
                "type": "string"
              },
              "year": {
                "type": "number"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Caveats the numbers cannot carry. Read these before presenting a unit value."
              },
              "source": {
                "type": "object"
              },
              "complete": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Whether the partner rows reconcile with the upstream's World total"
              },
              "partners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "partner": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "number"
                        },
                        "name": {
                          "type": "string"
                        }
                      }
                    },
                    "catalog_unit": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "net_weight_kg": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "primary_value_usd": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "unit_value_catalog": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The same figure in the instrument's own catalog unit, or null when there is no honest mass conversion (crude, gas and the grains price by volume or count)."
                    },
                    "unit_value_usd_per_kg": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Average realised price implied by this row (value / net weight). NOT a benchmark or spot price — it reflects the grades and terms that actually traded, and will differ from price.latest. Comparable across the rows of one response only."
                    }
                  }
                },
                "description": "Partners, highest value first"
              },
              "reporter": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "number"
                  },
                  "name": {
                    "type": "string"
                  }
                }
              },
              "returned": {
                "type": "number"
              },
              "commodity": {
                "type": "string"
              },
              "license_tag": {
                "type": "string"
              },
              "partner_count": {
                "type": "number",
                "description": "Partners the upstream returned, before any limit"
              },
              "shortfall_usd": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "world_total_usd": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "trade.ranking",
          "title": "Countries Ranked by Trade",
          "description": "Largest exporting or importing countries for a commodity in a year, ranked by value, each with the implied unit value it realised. Use for 'who are the biggest cocoa exporters' and 'which sourcing market is cheapest'. EXPORTS ARE NOT PRODUCTION: a country can be a large exporter of something it does not grow — the Netherlands ranks sixth in cocoa exports and grows none. Completeness cannot be verified for this shape, so `complete` is always null.",
          "inputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "year"
            ],
            "properties": {
              "flow": {
                "enum": [
                  "import",
                  "export"
                ],
                "type": "string",
                "description": "export ranks exporters, import ranks importers."
              },
              "year": {
                "type": "number",
                "description": "Four-digit year. Example: 2023."
              },
              "limit": {
                "type": "number",
                "description": "Maximum rows returned, 1-200 (default 25)."
              },
              "commodity": {
                "type": "string",
                "description": "Instrument code with an HS heading. Example: CC for cocoa."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "year",
              "reporters",
              "notes"
            ],
            "properties": {
              "flow": {
                "type": "string"
              },
              "year": {
                "type": "number"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Caveats the numbers cannot carry. Read these before presenting a unit value."
              },
              "source": {
                "type": "object"
              },
              "complete": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Always null here: the upstream publishes no aggregate over all reporters to reconcile against"
              },
              "returned": {
                "type": "number"
              },
              "commodity": {
                "type": "string"
              },
              "reporters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "reporter": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "number"
                        },
                        "name": {
                          "type": "string"
                        }
                      }
                    },
                    "catalog_unit": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "net_weight_kg": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "primary_value_usd": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "unit_value_catalog": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The same figure in the instrument's own catalog unit, or null when there is no honest mass conversion (crude, gas and the grains price by volume or count)."
                    },
                    "unit_value_usd_per_kg": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Average realised price implied by this row (value / net weight). NOT a benchmark or spot price — it reflects the grades and terms that actually traded, and will differ from price.latest. Comparable across the rows of one response only."
                    }
                  }
                },
                "description": "Countries, highest value first. Ranked by this service, not by the upstream, which returns rows ordered by country code."
              },
              "license_tag": {
                "type": "string"
              },
              "reporter_count": {
                "type": "number",
                "description": "Reporters the upstream returned, before any limit"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "observation.resolve",
          "title": "Resolve Observation",
          "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 value. Ids look like obs_<24 hex>.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Observation id, e.g. from a derived observation's inputs[] array."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "instrument",
              "name",
              "value",
              "unit",
              "as_of",
              "observed_at",
              "freshness_class",
              "quality",
              "derived",
              "source",
              "license_tag",
              "provenance",
              "series_id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable observation id"
              },
              "cite": {
                "type": "string",
                "description": "One-line citation for agents"
              },
              "name": {
                "type": "string",
                "description": "Human-readable instrument name"
              },
              "unit": {
                "type": "string",
                "description": "Unit of measure"
              },
              "as_of": {
                "type": "string",
                "description": "As-of date for the observation"
              },
              "prior": {
                "type": "number",
                "description": "Previous print value when history exists"
              },
              "value": {
                "type": "number",
                "description": "Observed numeric value"
              },
              "inputs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Input series ids when derived"
              },
              "source": {
                "type": "object",
                "required": [
                  "name",
                  "series_id",
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "series_id": {
                    "type": "string"
                  }
                },
                "description": "Primary source provenance"
              },
              "derived": {
                "type": "boolean",
                "description": "True when value is derived"
              },
              "formula": {
                "type": "string",
                "description": "Derivation formula when derived"
              },
              "quality": {
                "type": "string",
                "description": "Data quality label"
              },
              "raw_hash": {
                "type": "string",
                "description": "Hash of raw source payload"
              },
              "series_id": {
                "type": "string",
                "description": "Underlying series id"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code, e.g. CL"
              },
              "pct_change": {
                "type": "number",
                "description": "Percent change vs prior print"
              },
              "provenance": {
                "type": "object",
                "required": [
                  "retrieved_at",
                  "cache_hit",
                  "cache_ttl_s"
                ],
                "properties": {
                  "cache_hit": {
                    "type": "boolean"
                  },
                  "cache_ttl_s": {
                    "type": "number"
                  },
                  "retrieved_at": {
                    "type": "string"
                  }
                },
                "description": "Retrieval / cache provenance"
              },
              "license_tag": {
                "type": "string",
                "description": "License / redistribution tag"
              },
              "observed_at": {
                "type": "string",
                "description": "ISO timestamp when observed"
              },
              "short_history": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "as_of": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    }
                  }
                },
                "description": "Newest-first short history (≤8 points)"
              },
              "freshness_class": {
                "type": "string",
                "description": "Freshness class for the series"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "inventory.get",
          "title": "EIA Inventory",
          "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "series": {
                "type": "string",
                "description": "Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "series_key",
                    "series_id",
                    "name",
                    "value",
                    "unit",
                    "as_of",
                    "observed_at"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Inventory point id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Series display name"
                    },
                    "unit": {
                      "type": "string",
                      "description": "Unit of measure"
                    },
                    "as_of": {
                      "type": "string",
                      "description": "Report week as-of date"
                    },
                    "value": {
                      "type": "number",
                      "description": "Latest inventory level"
                    },
                    "vs_5y": {
                      "type": "number",
                      "description": "Deviation vs five-year average"
                    },
                    "avg_5y": {
                      "type": "number",
                      "description": "Five-year average when known"
                    },
                    "series_id": {
                      "type": "string",
                      "description": "EIA series id"
                    },
                    "prior_week": {
                      "type": "number",
                      "description": "Prior-week level when known"
                    },
                    "series_key": {
                      "type": "string",
                      "description": "Internal series key"
                    },
                    "wow_change": {
                      "type": "number",
                      "description": "Week-over-week change"
                    },
                    "observed_at": {
                      "type": "string",
                      "description": "ISO timestamp when observed"
                    }
                  }
                },
                "description": "All latest inventory points when series is omitted"
              },
              "vs_5y": {
                "type": "number",
                "description": "Deviation vs five-year average when series is provided"
              },
              "latest": {
                "type": "object",
                "required": [
                  "id",
                  "series_key",
                  "series_id",
                  "name",
                  "value",
                  "unit",
                  "as_of",
                  "observed_at"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Inventory point id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Series display name"
                  },
                  "unit": {
                    "type": "string",
                    "description": "Unit of measure"
                  },
                  "as_of": {
                    "type": "string",
                    "description": "Report week as-of date"
                  },
                  "value": {
                    "type": "number",
                    "description": "Latest inventory level"
                  },
                  "vs_5y": {
                    "type": "number",
                    "description": "Deviation vs five-year average"
                  },
                  "avg_5y": {
                    "type": "number",
                    "description": "Five-year average when known"
                  },
                  "series_id": {
                    "type": "string",
                    "description": "EIA series id"
                  },
                  "prior_week": {
                    "type": "number",
                    "description": "Prior-week level when known"
                  },
                  "series_key": {
                    "type": "string",
                    "description": "Internal series key"
                  },
                  "wow_change": {
                    "type": "number",
                    "description": "Week-over-week change"
                  },
                  "observed_at": {
                    "type": "string",
                    "description": "ISO timestamp when observed"
                  }
                },
                "description": "Latest point when a series key is provided"
              },
              "wow_change": {
                "type": "number",
                "description": "Week-over-week change when series is provided"
              },
              "surprise_label": {
                "type": "string",
                "description": "Surprise classification when series is provided"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "positioning.get",
          "title": "COT Positioning",
          "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Instrument code from catalog.list. Example: CL, NG, GC, ZC."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "id",
              "instrument",
              "report_date",
              "commodity_name",
              "mm_long",
              "mm_short",
              "mm_net",
              "mm_net_change",
              "source_url",
              "observed_at"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "COT row id"
              },
              "mm_net": {
                "type": "number",
                "description": "Managed-money net contracts"
              },
              "mm_long": {
                "type": "number",
                "description": "Managed-money long contracts"
              },
              "mm_short": {
                "type": "number",
                "description": "Managed-money short contracts"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code"
              },
              "source_url": {
                "type": "string",
                "description": "CFTC source URL"
              },
              "observed_at": {
                "type": "string",
                "description": "ISO timestamp when observed"
              },
              "report_date": {
                "type": "string",
                "description": "CFTC report date"
              },
              "mm_net_change": {
                "type": "number",
                "description": "Week-over-week change in managed-money net"
              },
              "commodity_name": {
                "type": "string",
                "description": "CFTC commodity name"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "spread.get",
          "title": "Derived Spread",
          "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 crack/crush/basis for live derived values with formula and inputs.",
          "inputSchema": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "root": {
                "type": "string",
                "description": "Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis."
              },
              "type": {
                "enum": [
                  "crack",
                  "crush",
                  "basis",
                  "calendar"
                ],
                "type": "string",
                "description": "Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable observation id"
              },
              "cite": {
                "type": "string",
                "description": "One-line citation for agents"
              },
              "name": {
                "type": "string",
                "description": "Human-readable instrument name"
              },
              "note": {
                "type": "string",
                "description": "Explanation when unavailable or partially degraded"
              },
              "root": {
                "type": "string",
                "description": "Calendar root when type=calendar"
              },
              "unit": {
                "type": "string",
                "description": "Unit of measure"
              },
              "as_of": {
                "type": "string",
                "description": "As-of date for the observation"
              },
              "prior": {
                "type": "number",
                "description": "Previous print value when history exists"
              },
              "value": {
                "type": "number",
                "description": "Observed numeric value"
              },
              "inputs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Input series ids when derived"
              },
              "source": {
                "type": "object",
                "required": [
                  "name",
                  "series_id",
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "series_id": {
                    "type": "string"
                  }
                },
                "description": "Primary source provenance"
              },
              "derived": {
                "type": "boolean",
                "description": "True when value is derived"
              },
              "formula": {
                "type": "string",
                "description": "Derivation formula when derived"
              },
              "quality": {
                "type": "string",
                "description": "Data quality label"
              },
              "raw_hash": {
                "type": "string",
                "description": "Hash of raw source payload"
              },
              "available": {
                "type": "boolean",
                "description": "False when the spread cannot be computed"
              },
              "series_id": {
                "type": "string",
                "description": "Underlying series id"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code, e.g. CL"
              },
              "pct_change": {
                "type": "number",
                "description": "Percent change vs prior print"
              },
              "provenance": {
                "type": "object",
                "required": [
                  "retrieved_at",
                  "cache_hit",
                  "cache_ttl_s"
                ],
                "properties": {
                  "cache_hit": {
                    "type": "boolean"
                  },
                  "cache_ttl_s": {
                    "type": "number"
                  },
                  "retrieved_at": {
                    "type": "string"
                  }
                },
                "description": "Retrieval / cache provenance"
              },
              "license_tag": {
                "type": "string",
                "description": "License / redistribution tag"
              },
              "observed_at": {
                "type": "string",
                "description": "ISO timestamp when observed"
              },
              "legs_quality": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "instrument",
                    "quality"
                  ],
                  "properties": {
                    "quality": {
                      "type": "string"
                    },
                    "instrument": {
                      "type": "string"
                    }
                  }
                },
                "description": "Per-leg quality when inputs are mixed"
              },
              "short_history": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "as_of": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    }
                  }
                },
                "description": "Newest-first short history (≤8 points)"
              },
              "freshness_class": {
                "type": "string",
                "description": "Freshness class for the series"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "price.history",
          "title": "Price History",
          "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Instrument code from catalog.list. Example: CL, GC, ZC."
              },
              "limit": {
                "type": "number",
                "description": "Number of historical points to return. Max 500, default 60."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "instrument",
              "series_id",
              "count",
              "data"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "instrument",
                    "name",
                    "value",
                    "unit",
                    "as_of",
                    "observed_at",
                    "freshness_class",
                    "quality",
                    "derived",
                    "source",
                    "license_tag",
                    "provenance",
                    "series_id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Stable observation id"
                    },
                    "cite": {
                      "type": "string",
                      "description": "One-line citation for agents"
                    },
                    "name": {
                      "type": "string",
                      "description": "Human-readable instrument name"
                    },
                    "unit": {
                      "type": "string",
                      "description": "Unit of measure"
                    },
                    "as_of": {
                      "type": "string",
                      "description": "As-of date for the observation"
                    },
                    "prior": {
                      "type": "number",
                      "description": "Previous print value when history exists"
                    },
                    "value": {
                      "type": "number",
                      "description": "Observed numeric value"
                    },
                    "inputs": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Input series ids when derived"
                    },
                    "source": {
                      "type": "object",
                      "required": [
                        "name",
                        "series_id",
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "series_id": {
                          "type": "string"
                        }
                      },
                      "description": "Primary source provenance"
                    },
                    "derived": {
                      "type": "boolean",
                      "description": "True when value is derived"
                    },
                    "formula": {
                      "type": "string",
                      "description": "Derivation formula when derived"
                    },
                    "quality": {
                      "type": "string",
                      "description": "Data quality label"
                    },
                    "raw_hash": {
                      "type": "string",
                      "description": "Hash of raw source payload"
                    },
                    "series_id": {
                      "type": "string",
                      "description": "Underlying series id"
                    },
                    "instrument": {
                      "type": "string",
                      "description": "Instrument code, e.g. CL"
                    },
                    "pct_change": {
                      "type": "number",
                      "description": "Percent change vs prior print"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "retrieved_at",
                        "cache_hit",
                        "cache_ttl_s"
                      ],
                      "properties": {
                        "cache_hit": {
                          "type": "boolean"
                        },
                        "cache_ttl_s": {
                          "type": "number"
                        },
                        "retrieved_at": {
                          "type": "string"
                        }
                      },
                      "description": "Retrieval / cache provenance"
                    },
                    "license_tag": {
                      "type": "string",
                      "description": "License / redistribution tag"
                    },
                    "observed_at": {
                      "type": "string",
                      "description": "ISO timestamp when observed"
                    },
                    "short_history": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "as_of": {
                            "type": "string"
                          },
                          "value": {
                            "type": "number"
                          }
                        }
                      },
                      "description": "Newest-first short history (≤8 points)"
                    },
                    "freshness_class": {
                      "type": "string",
                      "description": "Freshness class for the series"
                    }
                  }
                },
                "description": "Historical observations, newest first or as stored"
              },
              "count": {
                "type": "number",
                "description": "Number of points returned"
              },
              "series_id": {
                "type": "string",
                "description": "Underlying series id"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "fx.latest",
          "title": "Latest FX Rate",
          "description": "Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pair"
            ],
            "properties": {
              "pair": {
                "type": "string",
                "description": "FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "instrument",
              "name",
              "value",
              "unit",
              "as_of",
              "observed_at",
              "freshness_class",
              "quality",
              "derived",
              "source",
              "license_tag",
              "provenance",
              "series_id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable observation id"
              },
              "cite": {
                "type": "string",
                "description": "One-line citation for agents"
              },
              "name": {
                "type": "string",
                "description": "Human-readable instrument name"
              },
              "unit": {
                "type": "string",
                "description": "Unit of measure"
              },
              "as_of": {
                "type": "string",
                "description": "As-of date for the observation"
              },
              "prior": {
                "type": "number",
                "description": "Previous print value when history exists"
              },
              "value": {
                "type": "number",
                "description": "Observed numeric value"
              },
              "inputs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Input series ids when derived"
              },
              "source": {
                "type": "object",
                "required": [
                  "name",
                  "series_id",
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "series_id": {
                    "type": "string"
                  }
                },
                "description": "Primary source provenance"
              },
              "derived": {
                "type": "boolean",
                "description": "True when value is derived"
              },
              "formula": {
                "type": "string",
                "description": "Derivation formula when derived"
              },
              "quality": {
                "type": "string",
                "description": "Data quality label"
              },
              "raw_hash": {
                "type": "string",
                "description": "Hash of raw source payload"
              },
              "series_id": {
                "type": "string",
                "description": "Underlying series id"
              },
              "instrument": {
                "type": "string",
                "description": "Instrument code, e.g. CL"
              },
              "pct_change": {
                "type": "number",
                "description": "Percent change vs prior print"
              },
              "provenance": {
                "type": "object",
                "required": [
                  "retrieved_at",
                  "cache_hit",
                  "cache_ttl_s"
                ],
                "properties": {
                  "cache_hit": {
                    "type": "boolean"
                  },
                  "cache_ttl_s": {
                    "type": "number"
                  },
                  "retrieved_at": {
                    "type": "string"
                  }
                },
                "description": "Retrieval / cache provenance"
              },
              "license_tag": {
                "type": "string",
                "description": "License / redistribution tag"
              },
              "observed_at": {
                "type": "string",
                "description": "ISO timestamp when observed"
              },
              "short_history": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "as_of": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    }
                  }
                },
                "description": "Newest-first short history (≤8 points)"
              },
              "freshness_class": {
                "type": "string",
                "description": "Freshness class for the series"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "fundamentals.get",
          "title": "USDA/USGS Fundamentals",
          "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "kind"
            ],
            "properties": {
              "kind": {
                "enum": [
                  "wasde",
                  "crop_progress",
                  "export_sales",
                  "usgs"
                ],
                "type": "string",
                "description": "Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "id",
              "kind",
              "as_of",
              "observed_at",
              "payload"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Document id"
              },
              "kind": {
                "enum": [
                  "wasde",
                  "crop_progress",
                  "export_sales",
                  "usgs"
                ],
                "type": "string",
                "description": "Report kind echoed from the request"
              },
              "as_of": {
                "type": "string",
                "description": "Report as-of date"
              },
              "payload": {
                "type": "object",
                "description": "Kind-specific payload (quality, note, license_tag, freshness_class, and report fields)"
              },
              "observed_at": {
                "type": "string",
                "description": "ISO timestamp when retrieved"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "snapshot.get",
          "title": "Sector Snapshot",
          "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 sector picture.",
          "inputSchema": {
            "type": "object",
            "required": [
              "sector"
            ],
            "properties": {
              "sector": {
                "enum": [
                  "energy",
                  "metals",
                  "ags",
                  "all"
                ],
                "type": "string",
                "description": "Sector to snapshot. Use all to receive energy, metals, and ags together."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "truncated": true,
            "chars": 32668
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "calendar.get",
          "title": "Release Calendar",
          "description": "FREE. 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 agents around inventory or WASDE prints.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "events"
            ],
            "properties": {
              "events": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "source",
                    "cadence",
                    "typical_time_et",
                    "next_hint",
                    "next_release_at",
                    "notes",
                    "source_url"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Event id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Event name"
                    },
                    "notes": {
                      "type": "string",
                      "description": "Additional notes"
                    },
                    "source": {
                      "enum": [
                        "EIA",
                        "USDA",
                        "CFTC"
                      ],
                      "type": "string",
                      "description": "Publishing agency"
                    },
                    "cadence": {
                      "type": "string",
                      "description": "Release cadence"
                    },
                    "next_hint": {
                      "type": "string",
                      "description": "Hint for the next expected release"
                    },
                    "source_url": {
                      "type": "string",
                      "description": "The agency's own page for this release"
                    },
                    "next_release_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "ISO date YYYY-MM-DD in America/New_York for the next expected release"
                    },
                    "typical_time_et": {
                      "type": "string",
                      "description": "Typical release time in US/Eastern"
                    }
                  }
                },
                "description": "Upcoming / recurring release events"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "trade.codes",
          "title": "Country and HS Code Reference",
          "description": "Resolve a country to the UN M49 code the trade tools require, and list the HS headings this catalog maps. FREE. Call this BEFORE trade.flow, trade.partners or trade.ranking: those take a reporter code and there is no other way to discover one. Accepts ISO3, ISO2, a numeric M49 or an exact country name. Historical entities are excluded by default — twelve ISO3 codes resolve to more than one UN Comtrade entry and the expired one is never preferred, so IND gives India rather than pre-1974 India.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "country": {
                "type": "string",
                "description": "ISO3, ISO2, numeric M49 or exact name to resolve. Omit to list HS headings only."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodities"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "resolved": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "The matched country, when one was asked for"
              },
              "commodities": {
                "type": "array",
                "description": "Instrument code to HS heading"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "minerals.list",
          "title": "Mineral Coverage and HS Pairings",
          "description": "Which minerals the dossier covers, the HS code curated for each, and the caveats on comparing supply to trade. FREE. Worth calling before minerals.dossier for two reasons: the cobalt and lithium HS headings exist nowhere else in this API, since trade.codes lists headings only for catalog instruments and neither mineral has one; and the HS code here is chosen to match the USGS production basis, so copper, nickel and zinc point at ore headings rather than the refined-metal headings their instruments use. Also reports which minerals currently have US net import reliance and which column it was read from.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "minerals"
            ],
            "properties": {
              "edition": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "USGS MCS edition stored"
              },
              "minerals": {
                "type": "array",
                "description": "Per mineral: instrument, HS code and level, bases, caveats"
              },
              "not_mapped": {
                "type": "object",
                "description": "Minerals deliberately refused, with the reason"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "cash.reports",
          "title": "AMS Cash Grain Report Index",
          "description": "Which USDA AMS daily cash grain bid reports exist, which state and commodities each covers, and how fresh each is. FREE. Call before cash.bids to learn which states are covered and which reports have stopped publishing: liveness is current, stale (served and flagged), unlisted (AMS no longer lists it) or unknown. Three reports are published as covered-but-unparsed rather than omitted, because a visible gap beats a silent absence.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "report_count",
              "reports"
            ],
            "properties": {
              "reports": {
                "type": "array",
                "description": "Per report: slug, state, commodities, as_of, liveness"
              },
              "report_count": {
                "type": "integer"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "price.bundle",
          "title": "Latest Prices for Several Instruments",
          "description": "The latest observation for up to 20 instruments in ONE call. A separate tool from price.latest rather than an optional argument on it, because the two are priced differently and nothing binds a payment to a request body — one multiplexed entry point would let a caller quote the single price and send the bundle. Use this instead of looping price.latest: it is one settlement and one round trip. Codes that do not resolve come back with an error field rather than being dropped, and codes past the cap are listed in dropped_codes. Paid; charged only if at least one code resolves.",
          "inputSchema": {
            "type": "object",
            "required": [
              "codes"
            ],
            "properties": {
              "codes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1,
                "description": "Instrument codes, up to 20. Example: [\"CL\", \"BZ\", \"HG\"]."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "count",
              "observations"
            ],
            "properties": {
              "count": {
                "type": "integer"
              },
              "observations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "instrument",
                    "name",
                    "value",
                    "unit",
                    "as_of",
                    "observed_at",
                    "freshness_class",
                    "quality",
                    "derived",
                    "source",
                    "license_tag",
                    "provenance",
                    "series_id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Stable observation id"
                    },
                    "cite": {
                      "type": "string",
                      "description": "One-line citation for agents"
                    },
                    "name": {
                      "type": "string",
                      "description": "Human-readable instrument name"
                    },
                    "unit": {
                      "type": "string",
                      "description": "Unit of measure"
                    },
                    "as_of": {
                      "type": "string",
                      "description": "As-of date for the observation"
                    },
                    "prior": {
                      "type": "number",
                      "description": "Previous print value when history exists"
                    },
                    "value": {
                      "type": "number",
                      "description": "Observed numeric value"
                    },
                    "inputs": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Input series ids when derived"
                    },
                    "source": {
                      "type": "object",
                      "required": [
                        "name",
                        "series_id",
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "series_id": {
                          "type": "string"
                        }
                      },
                      "description": "Primary source provenance"
                    },
                    "derived": {
                      "type": "boolean",
                      "description": "True when value is derived"
                    },
                    "formula": {
                      "type": "string",
                      "description": "Derivation formula when derived"
                    },
                    "quality": {
                      "type": "string",
                      "description": "Data quality label"
                    },
                    "raw_hash": {
                      "type": "string",
                      "description": "Hash of raw source payload"
                    },
                    "series_id": {
                      "type": "string",
                      "description": "Underlying series id"
                    },
                    "instrument": {
                      "type": "string",
                      "description": "Instrument code, e.g. CL"
                    },
                    "pct_change": {
                      "type": "number",
                      "description": "Percent change vs prior print"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "retrieved_at",
                        "cache_hit",
                        "cache_ttl_s"
                      ],
                      "properties": {
                        "cache_hit": {
                          "type": "boolean"
                        },
                        "cache_ttl_s": {
                          "type": "number"
                        },
                        "retrieved_at": {
                          "type": "string"
                        }
                      },
                      "description": "Retrieval / cache provenance"
                    },
                    "license_tag": {
                      "type": "string",
                      "description": "License / redistribution tag"
                    },
                    "observed_at": {
                      "type": "string",
                      "description": "ISO timestamp when observed"
                    },
                    "short_history": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "as_of": {
                            "type": "string"
                          },
                          "value": {
                            "type": "number"
                          }
                        }
                      },
                      "description": "Newest-first short history (≤8 points)"
                    },
                    "freshness_class": {
                      "type": "string",
                      "description": "Freshness class for the series"
                    }
                  }
                }
              },
              "dropped_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "stats.bundle",
          "title": "Statistics for Several Instruments",
          "description": "Volatility, change and range for up to 20 instruments in ONE call. A separate tool from price.stats, for the same pricing reason as price.bundle. Returns the same derived statistics over the full retained history per instrument, with per-instrument errors rather than a whole-call failure when one has no history. Paid; charged only if at least one instrument resolves.",
          "inputSchema": {
            "type": "object",
            "required": [
              "codes"
            ],
            "properties": {
              "codes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1,
                "description": "Instrument codes, up to 20."
              },
              "windows": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Lookback windows, e.g. [\"30d\", \"90d\", \"1y\"]. Defaults to those three."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "count",
              "stats"
            ],
            "properties": {
              "count": {
                "type": "integer"
              },
              "stats": {
                "type": "array"
              },
              "dropped_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "producer.prices.bundle",
          "title": "Farm-Gate Prices for Several Crops",
          "description": "FAOSTAT farm-gate producer prices by country for up to 20 crops in ONE call. A separate tool from producer.prices, for the same pricing reason as price.bundle. This is what a grower was paid at the farm gate — NOT an export unit value and NOT the benchmark price.latest returns; all three are correct and differ. Paid; charged only if at least one crop resolves.",
          "inputSchema": {
            "type": "object",
            "required": [
              "codes"
            ],
            "properties": {
              "year": {
                "type": "integer",
                "description": "Year to summarise. Defaults to the latest stored."
              },
              "codes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1,
                "description": "Crop instrument codes, up to 20. Example: [\"CC\", \"KC\"]."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "count",
              "commodities"
            ],
            "properties": {
              "count": {
                "type": "integer"
              },
              "commodities": {
                "type": "array"
              },
              "dropped_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "account.quota",
          "title": "Remaining Credits on This Key",
          "description": "How many credits the calling Pro key has left in the current billing period, and which scopes it may read. FREE, and requires an API key in the Authorization header — x402 callers pay per request and have no quota to report. Use it to decide whether to spend on a bundle or a pack before calling one.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "credits_used",
              "billing_period",
              "scopes"
            ],
            "properties": {
              "plan": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "scopes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Empty means unrestricted"
              },
              "credits_used": {
                "type": "integer"
              },
              "billing_period": {
                "type": "string"
              },
              "credits_included": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "credits_remaining": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "minerals.dossier",
          "title": "Critical Minerals Supply and Trade",
          "description": "Who mines a mineral, who holds its reserves, and who exports it — USGS Mineral Commodity Summaries production and reserves by country, joined to UN Comtrade export flows and realised unit values, with supply concentration and US net import reliance. REFUSES three things: no ratio between the supply side and the trade side, because USGS counts contained metal while HS counts the gross weight of a traded article and for lithium those differ by about five times; no price of any kind; no criticality or supply-risk score. EXPORTS ARE NOT PRODUCTION — for gold and silver the largest reporters refine and vault rather than mine, so the two halves rank different countries for good reasons. The HS code matches the USGS production basis, so copper, nickel and zinc point at ore and concentrate headings rather than the refined-metal headings their instruments use. Annual data. Paid.",
          "inputSchema": {
            "type": "object",
            "required": [
              "mineral"
            ],
            "properties": {
              "year": {
                "type": "integer",
                "description": "Trade year for the Comtrade half. USGS years are fixed by the edition."
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "description": "Maximum country rows."
              },
              "mineral": {
                "enum": [
                  "aluminum",
                  "copper",
                  "gold",
                  "silver",
                  "nickel",
                  "zinc",
                  "iron_ore",
                  "cobalt",
                  "lithium"
                ],
                "type": "string",
                "description": "Which mineral. Required."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "mineral",
              "countries",
              "concentration",
              "comparability",
              "notes"
            ],
            "properties": {
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "trade": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Comtrade exports; null when the licence is unresolved"
              },
              "supply": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "USGS production and reserves, in the mineral's own unit"
              },
              "mineral": {
                "type": "string"
              },
              "countries": {
                "type": "array",
                "description": "Per-country supply and trade, largest producer first"
              },
              "instrument": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Catalog instrument where one quotes this metal; null for cobalt and lithium"
              },
              "comparability": {
                "type": "object",
                "description": "Whether the two sides may be compared at all"
              },
              "concentration": {
                "type": "object",
                "description": "Top-3 share and HHI per side, with formula and coverage"
              },
              "net_import_reliance": {
                "type": "object",
                "description": "US only, with the column it was read from"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "cash.bids",
          "title": "Cash Grain Bids and Basis",
          "description": "A country elevator's cash bid for physical grain, from USDA AMS daily cash grain bid reports, searched across every state report at once — which AMS itself cannot do, because MARS is report-centric with no commodity-wide search. Returns basis in CENTS per bushel against a named futures month, price in DOLLARS per bushel, location, grade, elevator class, freight and delivery. THIS IS NOT a futures settlement and NOT the NASS season-average price received that price.latest returns for ZC/ZW/ZS; all three are correct and all three differ. Values are ranges where the report published a range. Latest published print only — there is no stored history, so this cannot tell you whether basis is strengthening; read each row's basis_change, which is the agency's own answer. Wheat must name its class: CBOT soft red winter, KCBT hard red winter and MGE hard red spring traded 35 cents apart on the same page. Paid.",
          "inputSchema": {
            "type": "object",
            "required": [
              "commodity"
            ],
            "properties": {
              "limit": {
                "type": "integer",
                "minimum": 1,
                "description": "Maximum rows."
              },
              "month": {
                "type": "string",
                "description": "Futures month code (\"Z\") or contract (\"2026-12\") the basis is quoted against."
              },
              "state": {
                "type": "string",
                "description": "Two-letter state code, e.g. IA."
              },
              "commodity": {
                "enum": [
                  "corn",
                  "soybeans",
                  "wheat_srw",
                  "wheat_hrw",
                  "wheat_hrs",
                  "wheat_hard_white",
                  "sorghum"
                ],
                "type": "string",
                "description": "Which grain. Required."
              },
              "include_stale": {
                "type": "boolean",
                "description": "Include reports that have not published recently. Excluded and named by default."
              },
              "elevator_class": {
                "enum": [
                  "country_elevator",
                  "terminal_elevator",
                  "mill_or_processor",
                  "other"
                ],
                "type": "string",
                "description": "Narrow to one kind of buyer."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "commodity",
              "bids",
              "reports_searched",
              "notes"
            ],
            "properties": {
              "bids": {
                "type": "array",
                "description": "Cash bid rows, widest basis first"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "commodity": {
                "type": "string"
              },
              "instrument": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Catalog instrument where one quotes this class; null is a real answer"
              },
              "reports_searched": {
                "type": "integer"
              },
              "stale_reports_excluded": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "releases.next",
          "title": "Next Releases With Last Print",
          "description": "The release calendar joined to what each report last said: expected_at with a real Eastern offset, the last print's values, week-on-week change, the 5-year comparison, and a surprise label. Use this instead of calendar.get when you need the numbers as well as the timing — calendar.get answers only *when*. `last` is null when nothing is stored yet and surprise_label is null when no 5-year band exists; neither is ever guessed. Paid.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "release_id": {
                "enum": [
                  "eia-wpsr",
                  "eia-ng",
                  "cftc-cot",
                  "usda-wasde",
                  "usda-crop",
                  "usda-esr"
                ],
                "type": "string",
                "description": "One release id, as published by calendar.get"
              },
              "window_days": {
                "type": "integer",
                "minimum": 0,
                "description": "Keep only releases expected within this many days. Releases with no known date are excluded by a window."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "releases"
            ],
            "properties": {
              "releases": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "release_id",
                    "name",
                    "source",
                    "cadence",
                    "expected_date",
                    "expected_at",
                    "source_url",
                    "notes",
                    "last"
                  ],
                  "properties": {
                    "last": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "The last stored print, or null when nothing is stored for this release"
                    },
                    "name": {
                      "type": "string",
                      "description": "Release name"
                    },
                    "notes": {
                      "type": "string",
                      "description": "Additional notes"
                    },
                    "source": {
                      "enum": [
                        "EIA",
                        "USDA",
                        "CFTC"
                      ],
                      "type": "string",
                      "description": "Publishing agency"
                    },
                    "cadence": {
                      "type": "string",
                      "description": "Release cadence"
                    },
                    "release_id": {
                      "type": "string",
                      "description": "Release id"
                    },
                    "source_url": {
                      "type": "string",
                      "description": "The agency's own page"
                    },
                    "expected_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Full timestamp with Eastern offset, or null when no clock time is published for this release"
                    },
                    "expected_date": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "ISO date of the next expected release"
                    }
                  }
                },
                "description": "Releases, soonest first"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "decision.get",
          "title": "Decision Pack",
          "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "sector"
            ],
            "properties": {
              "sector": {
                "enum": [
                  "energy",
                  "metals",
                  "ags",
                  "all"
                ],
                "type": "string",
                "description": "Sector for the decision pack. Use all to bundle every sector."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "generated_at",
              "method"
            ],
            "properties": {
              "method": {
                "type": "string",
                "description": "Deterministic method identifier"
              },
              "sector": {
                "enum": [
                  "energy",
                  "metals",
                  "ags"
                ],
                "type": "string",
                "description": "Present for single-sector packs"
              },
              "sectors": {
                "type": "object",
                "description": "Present when sector=all"
              },
              "signals": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "direction",
                    "rationale"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "direction": {
                      "type": "string"
                    },
                    "rationale": {
                      "type": "string"
                    }
                  }
                },
                "description": "Directional signals with rationale"
              },
              "snapshot": {
                "type": "object",
                "required": [
                  "sector",
                  "as_of",
                  "prices",
                  "freshness_note"
                ],
                "properties": {
                  "cot": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "COT positioning rows when relevant"
                  },
                  "as_of": {
                    "type": "string",
                    "description": "Snapshot as-of timestamp"
                  },
                  "crush": {
                    "type": "object",
                    "required": [
                      "instrument",
                      "name",
                      "value",
                      "unit",
                      "as_of",
                      "observed_at",
                      "freshness_class",
                      "quality",
                      "derived",
                      "source",
                      "license_tag",
                      "provenance",
                      "series_id"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Stable observation id"
                      },
                      "cite": {
                        "type": "string",
                        "description": "One-line citation for agents"
                      },
                      "name": {
                        "type": "string",
                        "description": "Human-readable instrument name"
                      },
                      "unit": {
                        "type": "string",
                        "description": "Unit of measure"
                      },
                      "as_of": {
                        "type": "string",
                        "description": "As-of date for the observation"
                      },
                      "prior": {
                        "type": "number",
                        "description": "Previous print value when history exists"
                      },
                      "value": {
                        "type": "number",
                        "description": "Observed numeric value"
                      },
                      "inputs": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Input series ids when derived"
                      },
                      "source": {
                        "type": "object",
                        "required": [
                          "name",
                          "series_id",
                          "url"
                        ],
                        "properties": {
                          "url": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "series_id": {
                            "type": "string"
                          }
                        },
                        "description": "Primary source provenance"
                      },
                      "derived": {
                        "type": "boolean",
                        "description": "True when value is derived"
                      },
                      "formula": {
                        "type": "string",
                        "description": "Derivation formula when derived"
                      },
                      "quality": {
                        "type": "string",
                        "description": "Data quality label"
                      },
                      "raw_hash": {
                        "type": "string",
                        "description": "Hash of raw source payload"
                      },
                      "series_id": {
                        "type": "string",
                        "description": "Underlying series id"
                      },
                      "instrument": {
                        "type": "string",
                        "description": "Instrument code, e.g. CL"
                      },
                      "pct_change": {
                        "type": "number",
                        "description": "Percent change vs prior print"
                      },
                      "provenance": {
                        "type": "object",
                        "required": [
                          "retrieved_at",
                          "cache_hit",
                          "cache_ttl_s"
                        ],
                        "properties": {
                          "cache_hit": {
                            "type": "boolean"
                          },
                          "cache_ttl_s": {
                            "type": "number"
                          },
                          "retrieved_at": {
                            "type": "string"
                          }
                        },
                        "description": "Retrieval / cache provenance"
                      },
                      "license_tag": {
                        "type": "string",
                        "description": "License / redistribution tag"
                      },
                      "observed_at": {
                        "type": "string",
                        "description": "ISO timestamp when observed"
                      },
                      "short_history": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "as_of": {
                              "type": "string"
                            },
                            "value": {
                              "type": "number"
                            }
                          }
                        },
                        "description": "Newest-first short history (≤8 points)"
                      },
                      "freshness_class": {
                        "type": "string",
                        "description": "Freshness class for the series"
                      }
                    }
                  },
                  "wasde": {
                    "type": "object",
                    "description": "WASDE payload when relevant"
                  },
                  "prices": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "instrument",
                        "name",
                        "value",
                        "unit",
                        "as_of",
                        "observed_at",
                        "freshness_class",
                        "quality",
                        "derived",
                        "source",
                        "license_tag",
                        "provenance",
                        "series_id"
                      ],
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Stable observation id"
                        },
                        "cite": {
                          "type": "string",
                          "description": "One-line citation for agents"
                        },
                        "name": {
                          "type": "string",
                          "description": "Human-readable instrument name"
                        },
                        "unit": {
                          "type": "string",
                          "description": "Unit of measure"
                        },
                        "as_of": {
                          "type": "string",
                          "description": "As-of date for the observation"
                        },
                        "prior": {
                          "type": "number",
                          "description": "Previous print value when history exists"
                        },
                        "value": {
                          "type": "number",
                          "description": "Observed numeric value"
                        },
                        "inputs": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Input series ids when derived"
                        },
                        "source": {
                          "type": "object",
                          "required": [
                            "name",
                            "series_id",
                            "url"
                          ],
                          "properties": {
                            "url": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "series_id": {
                              "type": "string"
                            }
                          },
                          "description": "Primary source provenance"
                        },
                        "derived": {
                          "type": "boolean",
                          "description": "True when value is derived"
                        },
                        "formula": {
                          "type": "string",
                          "description": "Derivation formula when derived"
                        },
                        "quality": {
                          "type": "string",
                          "description": "Data quality label"
                        },
                        "raw_hash": {
                          "type": "string",
                          "description": "Hash of raw source payload"
                        },
                        "series_id": {
                          "type": "string",
                          "description": "Underlying series id"
                        },
                        "instrument": {
                          "type": "string",
                          "description": "Instrument code, e.g. CL"
                        },
                        "pct_change": {
                          "type": "number",
                          "description": "Percent change vs prior print"
                        },
                        "provenance": {
                          "type": "object",
                          "required": [
                            "retrieved_at",
                            "cache_hit",
                            "cache_ttl_s"
                          ],
                          "properties": {
                            "cache_hit": {
                              "type": "boolean"
                            },
                            "cache_ttl_s": {
                              "type": "number"
                            },
                            "retrieved_at": {
                              "type": "string"
                            }
                          },
                          "description": "Retrieval / cache provenance"
                        },
                        "license_tag": {
                          "type": "string",
                          "description": "License / redistribution tag"
                        },
                        "observed_at": {
                          "type": "string",
                          "description": "ISO timestamp when observed"
                        },
                        "short_history": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "as_of": {
                                "type": "string"
                              },
                              "value": {
                                "type": "number"
                              }
                            }
                          },
                          "description": "Newest-first short history (≤8 points)"
                        },
                        "freshness_class": {
                          "type": "string",
                          "description": "Freshness class for the series"
                        }
                      }
                    },
                    "description": "Latest prices for the sector"
                  },
                  "sector": {
                    "enum": [
                      "energy",
                      "metals",
                      "ags"
                    ],
                    "type": "string",
                    "description": "Sector covered by this snapshot"
                  },
                  "crack_321": {
                    "type": "object",
                    "required": [
                      "instrument",
                      "name",
                      "value",
                      "unit",
                      "as_of",
                      "observed_at",
                      "freshness_class",
                      "quality",
                      "derived",
                      "source",
                      "license_tag",
                      "provenance",
                      "series_id"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Stable observation id"
                      },
                      "cite": {
                        "type": "string",
                        "description": "One-line citation for agents"
                      },
                      "name": {
                        "type": "string",
                        "description": "Human-readable instrument name"
                      },
                      "unit": {
                        "type": "string",
                        "description": "Unit of measure"
                      },
                      "as_of": {
                        "type": "string",
                        "description": "As-of date for the observation"
                      },
                      "prior": {
                        "type": "number",
                        "description": "Previous print value when history exists"
                      },
                      "value": {
                        "type": "number",
                        "description": "Observed numeric value"
                      },
                      "inputs": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Input series ids when derived"
                      },
                      "source": {
                        "type": "object",
                        "required": [
                          "name",
                          "series_id",
                          "url"
                        ],
                        "properties": {
                          "url": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "series_id": {
                            "type": "string"
                          }
                        },
                        "description": "Primary source provenance"
                      },
                      "derived": {
                        "type": "boolean",
                        "description": "True when value is derived"
                      },
                      "formula": {
                        "type": "string",
                        "description": "Derivation formula when derived"
                      },
                      "quality": {
                        "type": "string",
                        "description": "Data quality label"
                      },
                      "raw_hash": {
                        "type": "string",
                        "description": "Hash of raw source payload"
                      },
                      "series_id": {
                        "type": "string",
                        "description": "Underlying series id"
                      },
                      "instrument": {
                        "type": "string",
                        "description": "Instrument code, e.g. CL"
                      },
                      "pct_change": {
                        "type": "number",
                        "description": "Percent change vs prior print"
                      },
                      "provenance": {
                        "type": "object",
                        "required": [
                          "retrieved_at",
                          "cache_hit",
                          "cache_ttl_s"
                        ],
                        "properties": {
                          "cache_hit": {
                            "type": "boolean"
                          },
                          "cache_ttl_s": {
                            "type": "number"
                          },
                          "retrieved_at": {
                            "type": "string"
                          }
                        },
                        "description": "Retrieval / cache provenance"
                      },
                      "license_tag": {
                        "type": "string",
                        "description": "License / redistribution tag"
                      },
                      "observed_at": {
                        "type": "string",
                        "description": "ISO timestamp when observed"
                      },
                      "short_history": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "as_of": {
                              "type": "string"
                            },
                            "value": {
                              "type": "number"
                            }
                          }
                        },
                        "description": "Newest-first short history (≤8 points)"
                      },
                      "freshness_class": {
                        "type": "string",
                        "description": "Freshness class for the series"
                      }
                    }
                  },
                  "inventory": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "id",
                        "series_key",
                        "series_id",
                        "name",
                        "value",
                        "unit",
                        "as_of",
                        "observed_at"
                      ],
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Inventory point id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Series display name"
                        },
                        "unit": {
                          "type": "string",
                          "description": "Unit of measure"
                        },
                        "as_of": {
                          "type": "string",
                          "description": "Report week as-of date"
                        },
                        "value": {
                          "type": "number",
                          "description": "Latest inventory level"
                        },
                        "vs_5y": {
                          "type": "number",
                          "description": "Deviation vs five-year average"
                        },
                        "avg_5y": {
                          "type": "number",
                          "description": "Five-year average when known"
                        },
                        "series_id": {
                          "type": "string",
                          "description": "EIA series id"
                        },
                        "prior_week": {
                          "type": "number",
                          "description": "Prior-week level when known"
                        },
                        "series_key": {
                          "type": "string",
                          "description": "Internal series key"
                        },
                        "wow_change": {
                          "type": "number",
                          "description": "Week-over-week change"
                        },
                        "observed_at": {
                          "type": "string",
                          "description": "ISO timestamp when observed"
                        }
                      }
                    },
                    "description": "Inventory points when relevant"
                  },
                  "export_sales": {
                    "type": "object",
                    "description": "Export sales payload when relevant"
                  },
                  "crop_progress": {
                    "type": "object",
                    "description": "Crop progress payload when relevant"
                  },
                  "freshness_note": {
                    "type": "string",
                    "description": "Freshness summary note"
                  }
                }
              },
              "disclaimer": {
                "type": "string",
                "description": "Non-advice / methodology disclaimer"
              },
              "generated_at": {
                "type": "string",
                "description": "ISO timestamp when the pack was generated"
              },
              "model_version": {
                "type": "string",
                "description": "Always null for rule-based packs; reserved field"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": "Primary-source commodities MCP. Start with catalog.list (free) to discover instrument codes, then price.latest / inventory.get / positioning.get for observations. Use trade.calculate for landed cost, margin, break-even or an FX shock over numbers you supply — nothing is sourced, and anything you omit comes back in `missing` rather than silently as zero. Use price.stats for how an instrument has behaved — volatility, change over a window, range — rather than pulling price.history and computing it yourself. Use snapshot.get for a sector bundle and decision.get for deterministic signal packs. calendar.get (free) lists EIA/USDA/CFTC release cadence; releases.next (paid) adds what each report last said and whether it surprised. cash.bids (paid) searches USDA AMS cash elevator bids and basis across every state grain report at once — a cash bid, not a futures settle and not the NASS price received. minerals.dossier (paid) gives mine production, reserves and export flows by country for nine minerals. 7 tools are FREE; the reference ones are worth calling first: trade.codes resolves a country to the M49 code the trade tools require (there is no other way to get one), minerals.list carries the curated mineral HS codes, and cash.reports lists the AMS grain reports and their freshness. Prefer the bundle tools over looping — price.bundle, stats.bundle and producer.prices.bundle each take up to 20 codes in one settlement. account.quota (free, needs an API key) reports credits left. AUTHENTICATION: paid tools need either a Pro credit key sent as the HTTP header `Authorization: Bearer cs_live_…` on this endpoint, or an x402 USDC payment on Base. The header is the practical route for an MCP client — the x402 challenge is an HTTP-level response a standard host cannot settle and retry. Without either, a paid tool returns isError with the reason and nothing is charged; call account.quota to confirm a key is being read."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}