Coal — Payments for AI agents

Connect Remote server

claude mcp add --transport http coal https://mcp.usecoal.xyz/api/mcp --header "X-Coal-Agent-Key: <X_COAL_AGENT_KEY>" --header "X-Coal-Api-Key: <X_COAL_API_KEY>"

{
  "mcpServers": {
    "coal": {
      "url": "https://mcp.usecoal.xyz/api/mcp",
      "headers": {
        "X-Coal-Agent-Key": "<X_COAL_AGENT_KEY>",
        "X-Coal-Api-Key": "<X_COAL_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "coal": {
      "type": "http",
      "url": "https://mcp.usecoal.xyz/api/mcp",
      "headers": {
        "X-Coal-Agent-Key": "<X_COAL_AGENT_KEY>",
        "X-Coal-Api-Key": "<X_COAL_API_KEY>"
      }
    }
  }
}

Settings > Connectors > Add custom connector
URL: https://mcp.usecoal.xyz/api/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 13 found in our last check

• 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 g…

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

• 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-re…

• 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-c…

• 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 downl…

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

Headers

Details

More ai and media servers See all

• bv7x strategy agents

  Find bv7x prediction agents on Robinhood Chain by market; quote their sealed calls, sold via x402.

• Chronary

  Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.

• Mastering

  Audio mastering for AI agents: LUFS analysis, Suno artifact cleanup, free daily master.

• Modulos AI Governance Platform

  Evaluate Modulos (EU AI Act, ISO 42001, NIST AI RMF): capabilities, trust, comparisons. Book a demo.

• naulon

  Check citations and retractions by DOI, and see the x402 price an AI agent pays to cite a source.

• NextConstraint

  Your SaaS funnel's costliest leak, its fix, watchdog alerts and verdicts, from NextConstraint.