Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Coal — Payments for AI agents

REMOTE · MCP.USECOAL.XYZ · SCANNED SEP 21

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

Available components

0 this week 78 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security63
Transport & Reachability100
Schema Quality & AI Usability71
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1977 tokens (~152/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 14 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities40
  • Spec-recency check failed: implements MCP spec 2025-03-26; the latest is 2026-07-28. See how to fix → Fail
Install

How do I install the Coal — Payments for AI agents MCP server?

Coal — Payments for AI agents is a hosted endpoint at https://mcp.usecoal.xyz/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · mcp.usecoal.xyz

# add to Claude Code
claude mcp add --transport http emmanuel39hanks-coal 'https://mcp.usecoal.xyz/api/mcp'
// .cursor/mcp.json
{
  "mcpServers": {
    "emmanuel39hanks-coal": {
      "url": "https://mcp.usecoal.xyz/api/mcp"
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "emmanuel39hanks-coal": {
      "type": "http",
      "url": "https://mcp.usecoal.xyz/api/mcp"
    }
  }
}
# ~/.codex/config.toml
[mcp_servers.emmanuel39hanks-coal]
url = "https://mcp.usecoal.xyz/api/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "emmanuel39hanks-coal": {
      "type": "remote",
      "url": "https://mcp.usecoal.xyz/api/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add emmanuel39hanks-coal --url 'https://mcp.usecoal.xyz/api/mcp' --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  emmanuel39hanks-coal:
    url: "https://mcp.usecoal.xyz/api/mcp"
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "emmanuel39hanks-coal": {
      "Transport": "http",
      "Url": "https://mcp.usecoal.xyz/api/mcp"
    }
  }
}
# add to Vellum
assistant mcp add emmanuel39hanks-coal -t streamable-http -u 'https://mcp.usecoal.xyz/api/mcp'
// mcp.json
{
  "mcpServers": {
    "emmanuel39hanks-coal": {
      "type": "http",
      "url": "https://mcp.usecoal.xyz/api/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 26 Aug 26 +2
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 25 Aug 26 0
    • Stability: 0.97 → pass security
  • 24 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

  • 11 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Jul 26 0

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Sept 2026 · Probed https://mcp.usecoal.xyz/api/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=mcp.usecoal.xyz CN=YR1,O=Let's Encrypt,C=US 15 Aug 2026 13 Nov 2026 RSA 2048 SHA256-RSA 57e4c7a63ad89885ef226ec060cbd256c92
SANs: mcp.usecoal.xyz
CN=YR1,O=Let's Encrypt,C=US (CA) CN=Root YR,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 RSA 2048 SHA256-RSA a20253f15f2691c05dc1ce13b9bcca4e
CN=Root YR,O=ISRG,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 RSA 4096 SHA256-RSA f24b6d17f9d9ad7cb1c9fea78782699f

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of mcp.usecoal.xyz. Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
xyz. present 3599, 18130 8, 8 Verified
usecoal.xyz. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200
Header Value
strict-transport-security max-age=63072000

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://mcp.usecoal.xyz/api/mcp Verified 200
http (plaintext) http://mcp.usecoal.xyz/api/mcp HTTPS enforced 308 https://mcp.usecoal.xyz/api/mcp
MCP tools · 13 exposed · ~1,304 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
agent_wallet_status ~119

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.

NameTypeReqDescription
addressstringPublic address to check (0x...). Optional if header is set.
agentPrivateKeystringYour agent wallet private key. Optional if X-Coal-Agent-Key header is set.

No output schema declared.

No examples provided.

check_paywall ~62

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

NameTypeReqDescription
addressstringWallet address to check (optional)
paywallIdstringyesPaywall ID

No output schema declared.

No examples provided.

create_checkout ~154

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.

NameTypeReqDescription
amountnumberyesPayment amount in USD
coalApiKeystringYour Coal API key (optional if X-Coal-Api-Key header is set)
descriptionstringPayment description
productIdstringOptional Coal product ID
productNamestringProduct name for the checkout page

No output schema declared.

No examples provided.

discover_merchants ~133

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_merchant after picking a match. Call this BEFORE asking the user where they want to buy from, BEFORE searching the web, BEFORE saying you can't purchase. Coal has a funded wallet ready (X-Coal-Agent-Key header) — your only job is to find the right product and confirm the spend.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

download_product ~166

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 click. Supported product slugs: `0g-cheatsheet` (The 0G Builder's Cheatsheet, $0.10).

NameTypeReqDescription
productstringyesProduct slug (e.g. `0g-cheatsheet`)
sessionIdstringCoal checkout session id (preferred for human-checkout flows)
txHashstringOn-chain tx hash from pay_merchant (preferred for agent flows)

No output schema declared.

No examples provided.

get_0g_health ~34

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

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_checkout_status ~39

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

NameTypeReqDescription
sessionIdstringyesCheckout session ID

No output schema declared.

No examples provided.

get_merchant_profile ~54

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

NameTypeReqDescription
merchantIdstringyesCoal merchant ID

No output schema declared.

No examples provided.

pay_merchant ~225

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-uses the wallet key from the X-Coal-Agent-Key header in your Claude config (no need to ask the user for a key). Max $5 per tx. After this succeeds for a digital product, immediately call download_product with the returned tx hash to give the user their file.

NameTypeReqDescription
agentPrivateKeystringYour wallet private key. Optional if X-Coal-Agent-Key header is set.
amountnumberyesAmount in USD (USDC). Max $5 per tx.
reasonstringWhy this payment is being made (free-form, for logs)
sessionIdstringOptional checkout session ID to confirm against
tostringyesMerchant payout address (0x...)

No output schema declared.

No examples provided.

query_merchant_memory ~132

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.

NameTypeReqDescription
coalApiKeystringYour Coal API key (optional if X-Coal-Api-Key header is set)
merchantIdstringyesCoal merchant ID
questionstringyesNatural language question

No output schema declared.

No examples provided.

search_products ~86

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

NameTypeReqDescription
maxPricenumberMaximum price in USD
searchstringProduct name search (fuzzy)
tagstringFilter by product tag

No output schema declared.

No examples provided.

setup_instructions ~43

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

verify_receipt ~57

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

NameTypeReqDescription
sessionIdstringyesCheckout session ID

No output schema declared.

No examples provided.

Common questions

What is the Coal — Payments for AI agents MCP server?

Coal — Payments for AI agents is an MCP server listed in the public MCP registry as io.github.emmanuel39hanks/coal. Payment rails for AI agents. Pay merchants in USDC on Base. Dual-protocol: x402 + OKX APP. This page covers its hosted endpoint (https://mcp.usecoal.xyz/api/mcp).

Is the Coal — Payments for AI agents MCP server safe to use?

Coal — Payments for AI agents scores 78 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Coal — Payments for AI agents MCP server expose?

Coal — Payments for AI agents exposes 13 tools: discover_merchants, search_products, get_merchant_profile, query_merchant_memory, check_paywall, and 8 more. Their descriptions and schemas cost roughly 1,304 tokens of context every time the server is loaded.

Does the Coal — Payments for AI agents MCP server require authentication?

No. We connected to Coal — Payments for AI agents without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the Coal — Payments for AI agents MCP server still maintained?

Coal — Payments for AI agents is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.