Coal — Payments for AI agents

emmanuel39hanks/coal

Adds USDC payment rails on Base directly to Claude Desktop. Exposes merchant discovery, checkout session creation, payment verification, and receipt lookups through a multi-tenant MCP endpoint. Implements dual-protocol agent payments: Coinbase x402 paywalls and OKX APP envelopes hit the same verification route. Payment receipts get published to 0G Storage and anchored on-chain with proof hashes. The server wraps Coal's hosted checkout API, so agents can initiate purchases, poll transaction status, and retrieve verifiable receipts without leaving the MCP context. Useful when you want Claude to autonomously pay for digital goods, query merchant catalogs, or build commerce workflows that settle in stablecoins.

GitHub stars: 1
tools: 13
auth: Secret needed
transport: HTTP
last updated: May 7, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.usecoal.xyz/api/mcp --name coal --header 'X-Coal-Agent-Key: ${X_COAL_AGENT_KEY}' --header 'X-Coal-Api-Key: ${X_COAL_API_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http coal https://mcp.usecoal.xyz/api/mcp --header 'X-Coal-Agent-Key: YOUR_X_COAL_AGENT_KEY' --header 'X-Coal-Api-Key: YOUR_X_COAL_API_KEY'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 13 tools

Verified live against the running server on Nov 6, 2026.

discover_merchantsTHE 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...

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

No parameters. Call it with no arguments.

search_productsSearch 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".3 params

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".

Parameters* required

maxPricenumber

Maximum price in USD

searchstring

Product name search (fuzzy)

tagstring

Filter by product tag

get_merchant_profileGet the full profile of a Coal merchant including products (with images), paywalls, supported networks/tokens, and 0G Storage proof. Returns rendered Markdown.1 params

Get the full profile of a Coal merchant including products (with images), paywalls, supported networks/tokens, and 0G Storage proof. Returns rendered Markdown.

Parameters* required

merchantId*string

Coal merchant ID

query_merchant_memoryAsk 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://usecoa...3 params

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://usecoa...

Parameters* required

coalApiKeystring

Your Coal API key (optional if X-Coal-Api-Key header is set)

merchantId*string

Coal merchant ID

question*string

Natural language question

check_paywallCheck whether an address has paid for a specific x402 paywall. Returns pricing info if not paid, or content access status if paid.2 params

Check whether an address has paid for a specific x402 paywall. Returns pricing info if not paid, or content access status if paid.

Parameters* required

addressstring

Wallet address to check (optional)

paywallId*string

Paywall ID

create_checkoutCreate 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.5 params

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.

Parameters* required

amount*number

Payment amount in USD

coalApiKeystring

Your Coal API key (optional if X-Coal-Api-Key header is set)

descriptionstring

Payment description

productIdstring

Optional Coal product ID

productNamestring

Product name for the checkout page

get_checkout_statusCheck the payment status of a checkout session: pending, verifying, confirmed, expired, failed.1 params

Check the payment status of a checkout session: pending, verifying, confirmed, expired, failed.

Parameters* required

sessionId*string

Checkout session ID

verify_receiptVerify a payment receipt and see its 3-step proof trail: (1) Base TX, (2) 0G Storage receipt, (3) 0G Chain anchor.1 params

Verify a payment receipt and see its 3-step proof trail: (1) Base TX, (2) 0G Storage receipt, (3) 0G Chain anchor.

Parameters* required

sessionId*string

Checkout session ID

get_0g_healthCheck the live status of all 5 0G components: Storage, Chain, Compute, KV, DA.

Check the live status of all 5 0G components: Storage, Chain, Compute, KV, DA.

No parameters. Call it with no arguments.

agent_wallet_statusCheck 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-...2 params

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

Parameters* required

addressstring

Public address to check (0x...). Optional if header is set.

agentPrivateKeystring

Your agent wallet private key. Optional if X-Coal-Agent-Key header is set.

pay_merchantSend 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...5 params

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

Parameters* required

agentPrivateKeystring

Your wallet private key. Optional if X-Coal-Agent-Key header is set.

amount*number

Amount in USD (USDC). Max $5 per tx.

reasonstring

Why this payment is being made (free-form, for logs)

sessionIdstring

Optional checkout session ID to confirm against

to*string

Merchant payout address (0x...)

download_productRetrieve / 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 dow...3 params

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 dow...

Parameters* required

product*string

Product slug (e.g. `0g-cheatsheet`)

sessionIdstring

Coal checkout session id (preferred for human-checkout flows)

txHashstring

On-chain tx hash from pay_merchant (preferred for agent flows)

setup_instructionsPrint 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.

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.

No parameters. Call it with no arguments.

Readme

Coal

0G APAC Hackathon 2026 — Track 3: Agentic Economy

Payments for humans and AI agents — one checkout, real USDC on Base, verifiable receipts on 0G.

Surface	URL
Marketing site	usecoal.xyz
Public API	api.usecoal.xyz
Hosted checkout	usecoal.xyz/pay/...
Live AI-agent demo (Claude buying ebooks)	agent.usecoal.xyz
Demo merchant store (with download flow)	store.usecoal.xyz
MCP server (multi-tenant)	mcp.usecoal.xyz/api/mcp
x402 oracle paywall demo	oracle.usecoal.xyz/api/price/ETH
Live 0G health (all 5 components)	api.usecoal.xyz/api/0g/health
Docs site	usecoal.xyz/docs
React SDK on npm	`coal-react` v0.4.1

🎥 Watch

View the full README on GitHub

Details

Repository: github.com/emmanuel39hanks/coal
Website: usecoal.xyz
Category: Finance & Commerce
Transport: HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Finance & Commerce MCP servers

View all

Hyperd Mcphyperd-ai/hyperd-mcpPre-trade DeFi intelligence: 24 paid x402 tools incl. 6 synthesis verdicts, USDC on Base.1stars

Mcp Hd Walletcryptoapis-io/cryptoapis-mcp-hd-walletMCP server for HD wallet management, balance, and sync on EVM, UTXO, XRP via Crypto APIs0stars

Cryptoizdadang11/cryptoiz-mcpSolana DEX whale intelligence: alpha, divergence, phase scoring, BTC regime. USDC payments via x402.1stars

Cobroyadan1d/mercadopago-toolMercado Pago payments for AI agents: payment links, search, refunds, merchant info.0stars

Grubhubmarkswendsen-code/mcp-grubhubMCP server for GrubHub - let AI agents order food and manage restaurant delivery autonomously1stars

Ubereatsmarkswendsen-code/mcp-ubereatsMCP server for Uber Eats - let AI agents order food delivery1stars