# x402-commodity-mcp

MCP server for **Côte d'Ivoire & global soft-commodity data** — cocoa, coffee, sugar,
cotton, cashew — paid per call in USDC on Base mainnet via the
[x402](https://x402.org) protocol. No API key, no account.

Wraps the [CIV commodity-data API](https://data.lagoontechsystems.com) as **19 MCP tools**:
CIV farmgate floor prices (set by CCC / CCA by decree), ICE Futures US settlements,
CFTC COT positioning, and historical series. Each call settles its price automatically
from **your** wallet.

## Install / run

```bash
npx x402-commodity-mcp
```

Configure your MCP client to launch `npx x402-commodity-mcp`.

## Configuration (env)

| Var | Default | Notes |
|-----|---------|-------|
| `BUYER_WALLET_PATH` | `~/.x402-buyer/wallet.json` | **You supply this.** `{ "private_key": "0x..." }`, funded with a little USDC on Base. |
| `X402_DATA_URL` | `https://data.lagoontechsystems.com` | Target service base. |
| `MCP_TRANSPORT` | `stdio` | `stdio` or `http`. |

> **You pay for your own calls.** Use a dedicated, lightly-funded wallet.

## Tools (19)

`cocoa_price` `cocoa_futures` `cocoa_composite` `cocoa_history` · `coffee_price`
`coffee_futures` `coffee_composite` `coffee_history` · `sugar_price` `sugar_futures`
`sugar_composite` `sugar_history` · `cotton_futures` `cotton_composite` `cotton_history`
· `cashew_price` `cashew_wholesale` `cashew_composite` `cashew_history`

**Pricing (USDC/call):** `*/price` & `cashew/wholesale` $0.01 · `*/futures` $0.03 ·
`*/history` (optional `days` 1-365) $0.05 · `*/composite` (bundled farmgate + futures +
COT + trend) $0.10.

## Provider

[Lagoon Tech Systems](https://lagoontechsystems.com). MIT licensed.