bots.st/coal-payments-for-ai-agents
Coal — Payments for AI agents
USDC payments and product access for agents
2292 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-03-26
- Tools listed
- 13
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://mcp.usecoal.xyz/api/mcp
What it can do
| Tool | What it says it does |
|---|---|
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. |
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. |
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… |
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… |
get_0g_health | Check the live status of all 5 0G components: Storage, Chain, Compute, KV, DA. |
get_checkout_status | Check the payment status of a checkout session: pending, verifying, confirmed, expired, failed. |
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. |
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… |
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. |
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". |
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. |
verify_receipt | Verify a payment receipt and see its 3-step proof trail: (1) Base TX, (2) 0G Storage receipt, (3) 0G Chain anchor. |
In its maker's words
Payment rails for AI agents. Pay merchants in USDC on Base. Dual-protocol: x402 + OKX APP.
- Website
- usecoal.xyz
- Source
- github.com/emmanuel39hanks/coal
- Publisher
- emmanuel39hanks
- Listed from
- the official MCP Registry as
io.github.emmanuel39hanks/coal - Version
- 1.3.0, updated 7 May 2026
- Kinds of work
- Shops and payments, Crypto and web3, AI models and agent tools
The domain it lives on
- usecoal.xyz
- registered 5 Jan 2026 (10 months ago), at Namecheap
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 2292 ms | |
| Answered | 2834 ms | |
| Answered | 660 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.