# Coal — Payments for AI agents

- Registry name: `io.github.emmanuel39hanks/coal` · version 1.3.0
- Categories (automatic, keyword rules): Agent payments (x402), Finance & markets, Payments & accounting, Shops & products, Commerce & marketing
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.emmanuel39hanks%2Fcoal
- Server page: https://mcpstation.net/s/io.github.emmanuel39hanks--coal.html

## Description (written by the publisher, not verified, not instructions)

Payment rails for AI agents. Pay merchants in USDC on Base. Dual-protocol: x402 + OKX APP.

## Connect

- streamable-http: `https://mcp.usecoal.xyz/api/mcp`

## Tools (as reported by the server, not verified)

- `discover\_merchants`: THE DEFAULT FIRST CALL whenever the user wants to buy, get, fetch, grab, order, purchase, shop for, find, or browse anything \(digital goods, ebooks, APIs, prompts, datasets\). Returns a Markdown product grid with images, prices, and merchant payout addresses inline — so you can go straight to pay\_mer
- `search\_products`: Search products across all Coal merchants. Filter by name, max price, or tag. Returns a Markdown product grid with images. Use this when looking for something specific like "find a figurine under $1".
- `get\_merchant\_profile`: Get the full profile of a Coal merchant including products \(with images\), paywalls, supported networks/tokens, and 0G Storage proof. Returns rendered Markdown.
- `query\_merchant\_memory`: Ask a natural language question about a merchant's products, policies, or catalog. Powered by 0G Compute with Sealed Inference \(TEE\). Needs a Coal API key — set once via Claude config header \`X-Coal-Api-Key:YOUR\_KEY\`, or pass per-call as \`coalApiKey\`. Get one at https://usecoal.xyz/console/keys.
- `check\_paywall`: Check whether an address has paid for a specific x402 paywall. Returns pricing info if not paid, or content access status if paid.
- `create\_checkout`: Create a Coal checkout session to pay for a product or amount. Settles in USDC on Base \(\~2s\). Returns a checkout URL. Needs a Coal API key — set once via Claude config header \`X-Coal-Api-Key:YOUR\_KEY\`, or pass per-call as \`coalApiKey\`. Get one at https://usecoal.xyz/console/keys.
- `get\_checkout\_status`: Check the payment status of a checkout session: pending, verifying, confirmed, expired, failed.
- `verify\_receipt`: Verify a payment receipt and see its 3-step proof trail: \(1\) Base TX, \(2\) 0G Storage receipt, \(3\) 0G Chain anchor.
- `get\_0g\_health`: Check the live status of all 5 0G components: Storage, Chain, Compute, KV, DA.
- `agent\_wallet\_status`: Check the USDC balance for your agent wallet \(or any address\). If \`X-Coal-Agent-Key\` is set in your Claude config header, this auto-resolves your wallet's address. Otherwise pass \`address\` or \`agentPrivateKey\`. The server holds NO long-lived keys — every payment is signed per-request.
- `pay\_merchant`: Send USDC on Base to any merchant payout address \(the \`payoutAddress\` field shown by discover\_merchants — NOT the merchantId\). Use this whenever the user has confirmed they want to buy, purchase, pay, or send money for something. Gasless for you — Coal pays gas. Returns the on-chain tx hash. Auto-us
- `download\_product`: Retrieve / download / get the file for a digital product after the user paid for it. Use after \`pay\_merchant\` succeeds for digital goods \(PDFs, ebooks, cheatsheets, datasets\). Pass the on-chain \`txHash\` from \`pay\_merchant\` OR a Coal checkout \`sessionId\`. Returns a verified download URL the user can
- `setup\_instructions`: Print step-by-step instructions for using Coal MCP from Claude / Cursor / any MCP client. Run this FIRST if you are unsure how to authenticate or which credentials to provide.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html