Coal - Payments for AI agents — Claude Code MCP server setup
Coal - Payments for AI agents gives agents tools to browse decentralized product listings, send USDC on Base, and fetch purchased files autonomously.
no license 1,558 installs updated 2026-05-07
claude mcp add --transport http coal-payments https://coal-payments--coal.run.toolsWhat Coal - Payments for AI agents does
This MCP server connects models to merchant catalogs on 0G Storage and settles payments on Base using USDC via x402 or OKX APP envelopes. Agents can filter products, inspect seller profiles, and complete purchases without manual user approval. Transactions leave an auditable trail anchored to 0G Chain.
The package exposes 13 tools covering the entire buying flow: discover_merchants, pay_merchant, download_product, and verify_receipt. Once a payment clears, the agent fetches the final download link for files such as datasets, prompts, or ebooks. Coal handles network gas fees automatically.
Architecture is multi-tenant and stores zero long-term custody secrets on the host. Every call signs with a key provided via the X-Coal-Agent-Key header or an inline parameter. Generating checkout sessions or querying merchant memory requires X-Coal-Api-Key, so you must obtain this credential before using those specific tools.
What it helps with
- search digital products and datasets across decentralized merchants
- execute autonomous USDC transfers on Base without paying gas
- download digital assets using on-chain transaction hashes
- verify payment audit trails against 0G Chain anchors
Example prompts for the agent
- Search Coal merchants for machine learning datasets priced under 10 USDC.
- Check the paywall status and pay the merchant payout address on Base.
- Download the digital file using the transaction hash from our previous checkout.
How to install Coal - Payments for AI agents
Platform CLI: remote server
claude mcp add --transport http coal-payments https://coal-payments--coal.run.toolsPlatform CLI: remote server
codex mcp add coal-payments-for-ai-agents --url https://coal-payments--coal.run.toolsConfig file
{
"mcpServers": {
"coal-payments-for-ai-agents": {
"url": "https://coal-payments--coal.run.tools"
}
}
}Config file
{
"servers": {
"coal-payments-for-ai-agents": {
"type": "http",
"url": "https://coal-payments--coal.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http coal-payments-for-ai-agents https://coal-payments--coal.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Coal - Payments for AI agents
How do I install Coal - Payments for AI agents in Claude Code?
Run claude mcp add --transport http coal-payments https://coal-payments--coal.run.tools in your terminal. This configures the remote HTTP endpoint.
What does the Coal MCP server do?
It equips agents with autonomous checkout capabilities, enabling them to discover merchant offerings, pay in USDC on Base, and download digital products.
Does the agent need native Base ETH to cover transaction gas?
No, transactions are gasless for the agent because Coal covers operator gas fees. The wallet only needs a sufficient USDC balance and signing credentials.