Model Context Protocol (MCP) server for freee API integration
Primary Source Commodities is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http primary-source-commodities-mcp https://api.commodities.sh/api/mcp
# 2 — ask your agent for something these tools do
# catalog.list, price.latest, inventory.get and 8 more
Primary Source Commodities costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http primary-source-commodities-mcp https://api.commodities.sh/api/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
11 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| code | string | yes | Instrument code from catalog.list. Example: CL, GC, ZC. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| series | string | no | Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| code | string | yes | Instrument code from catalog.list. Example: CL, NG, GC, ZC. |
Compute a derived spread observation: 3-2-1 crack, soybean crush, WTI-Brent basis, or calendar (calendar requires licensed curve data and may return available=false). Prefer crack/crush/basis for live derived values with formula and inputs.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| type | string | yes | Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack. |
| root | string | no | Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| code | string | yes | Instrument code from catalog.list. Example: CL, GC, ZC. |
| limit | number | no | Number of historical points to return. Max 500, default 60. |
Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pair | string | yes | FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| kind | string | yes | Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sector | string | yes | Sector to snapshot. Use all to receive energy, metals, and ags together. |
List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, and next-hint notes. Free discovery tool — call before scheduling agents around inventory or WASDE prints.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sector | string | yes | Sector for the decision pack. Use all to bundle every sector. |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Primary Source Commodities or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.1.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Primary Source Commodities can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.