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 protocol. No API key, no account.

Wraps the CIV commodity-data API 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

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. MIT licensed.