Back to search
100
MCP live v1.3.0 streamable-http

Coal — Payments for AI agents

io.github.emmanuel39hanks/coal

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

Uptime
5.3%
19 probes
Response
719ms
last probe
Tools
13
callable
Primary URL
https://mcp.usecoal.xyz/api/mcp

Tools · 13

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 produc…

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-A…

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`…

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 `agentPr…

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,…

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 `txHas…

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.

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "coal_—_payments_for_ai_agents": {
      "url": "https://mcp.usecoal.xyz/api/mcp",
      "transport": "streamable-http"
    }
  }
}