How do I use x402-commodity-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@x402-commodity-mcp what's the cocoa farmgate price today?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.