MCP server

Coal — Payments for AI agents

io.github.emmanuel39hanks/coal

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

13

Token cost

About 1,990 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http coal https://mcp.usecoal.xyz/api/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.coal]
url = "https://mcp.usecoal.xyz/api/mcp"

Gemini CLI

{"mcpServers":{"coal":{"httpUrl":"https://mcp.usecoal.xyz/api/mcp"}}}

Cursor

{"mcpServers":{"coal":{"url":"https://mcp.usecoal.xyz/api/mcp"}}}

VS Code

{"servers":{"coal":{"type":"http","url":"https://mcp.usecoal.xyz/api/mcp"}}}

Antigravity

agy mcp add coal https://mcp.usecoal.xyz/api/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"coal","server_url":"https://mcp.usecoal.xyz/api/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"coal","server_url":"https://mcp.usecoal.xyz/api/mcp"}

Tools

• agent_wallet_status ~175 tokens
  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 ~109 tokens
  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 Moves money · ~226 tokens
  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 ~196 tokens
  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
• download_product ~227 tokens
  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
• get_0g_health ~52 tokens
  Check the live status of all 5 0G components: Storage, Chain, Compute, KV, DA.
• get_checkout_status ~81 tokens
  Check the payment status of a checkout session: pending, verifying, confirmed, expired, failed.
• get_merchant_profile ~99 tokens
  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 Moves money · ~324 tokens
  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
• query_merchant_memory ~193 tokens
  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 ~141 tokens
  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 ~82 tokens
  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 ~85 tokens
  Verify a payment receipt and see its 3-step proof trail: (1) Base TX, (2) 0G Storage receipt, (3) 0G Chain anchor.

Browse

• Claude tools
• GitHub tools
• Converting to Markdown
• Payments
• GitHub and code hosting
• Crypto and blockchains

Related MCP servers

• Facet UCP Shopping
  The independent agent-commerce protocol for AI-agent checkout on any online store.
• DESK LEAD x402 — high-ticket packs $50/$100/$150
  ~17 tools; HT packs $50/$100/$150. tools/list free; tools/call USDC Base x402. Not financial advice.
• GW8 Signal API
  Pay-per-call crypto signals, token verdicts, flows & briefs. x402 USDC on Base. Signal-only.
• Conclave Agent-Rails
  Pay-per-call x402 data tools on Base: Solana snapshots, prices, package metadata.
• Conclave Agent-Rails
  Pay-per-call x402 data tools on Base: Solana snapshots, prices, package metadata.
• Oblique Markets
  x402-paid analytics, market intelligence, research, and LLM inference for AI agents.
• Tollbooth
  37 paid x402 MCP tools for OSINT, prediction markets, web intel, and agent security on Base USDC.
• AgentWorld — Live AI Agent Economy
  Live AI agent economy on Base L2: agents, credit files, games, jobs, crypto news, x402 USDC tools.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.emmanuel39hanks/coal.svg)](https://aptlynx.net/servers/io.github.emmanuel39hanks/coal)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents