# Coal - Payments for AI agents

Coal - Payments for AI agents gives agents tools to browse decentralized product listings, send USDC on Base, and fetch purchased files autonomously.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1558 installs
- Author: coal
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/coal/coal-payments
- Updated: 2026-05-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/coal-payments-for-ai-agents

## What it does

This MCP server connects models to merchant catalogs on 0G Storage and settles payments on Base using USDC via x402 or OKX APP envelopes. Agents can filter products, inspect seller profiles, and complete purchases without manual user approval. Transactions leave an auditable trail anchored to 0G Chain.

The package exposes 13 tools covering the entire buying flow: `discover_merchants`, `pay_merchant`, `download_product`, and `verify_receipt`. Once a payment clears, the agent fetches the final download link for files such as datasets, prompts, or ebooks. Coal handles network gas fees automatically.

Architecture is multi-tenant and stores zero long-term custody secrets on the host. Every call signs with a key provided via the `X-Coal-Agent-Key` header or an inline parameter. Generating checkout sessions or querying merchant memory requires `X-Coal-Api-Key`, so you must obtain this credential before using those specific tools.

## Requirements
- Remote server: `https://coal-payments--coal.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http coal-payments https://coal-payments--coal.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add coal-payments-for-ai-agents --url https://coal-payments--coal.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "coal-payments-for-ai-agents": {
            "url": "https://coal-payments--coal.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "coal-payments-for-ai-agents": {
            "type": "http",
            "url": "https://coal-payments--coal.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http coal-payments-for-ai-agents https://coal-payments--coal.run.tools
```

## When to use it
- search digital products and datasets across decentralized merchants
- execute autonomous USDC transfers on Base without paying gas
- download digital assets using on-chain transaction hashes
- verify payment audit trails against 0G Chain anchors

## Example prompts
- Search Coal merchants for machine learning datasets priced under 10 USDC.
- Check the paywall status and pay the merchant payout address on Base.
- Download the digital file using the transaction hash from our previous checkout.

## Similar
- [FiatDock](https://affpapa.org/en/nevibecode/mcp/fiatdock.md) — MCP server · ★ 1 repo stars
- [mcp](https://affpapa.org/en/nevibecode/mcp/walletbureau-mcp.md) — MCP server
- [Liquid Agent](https://affpapa.org/en/nevibecode/mcp/liquid-agent.md) — MCP server
- [Neuronto Payments: x402 facilitator and API gateway](https://affpapa.org/en/nevibecode/mcp/neuronto-payments-x402-facilitator-and-api-gateway.md) — MCP server
- [Spraay](https://affpapa.org/en/nevibecode/mcp/spraay.md) — MCP server · 1864 installs
- [xenarch-mcp](https://affpapa.org/en/nevibecode/mcp/xenarch-mcp.md) — MCP server · 974 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
