ToolTrust
A2/100
Smithery

coal-coal-payments

mcpsmithery

@Smithery

# Coal Coal gives AI agents a real checkout. Discover merchants through the decentralized 0G Storage catalog, pay autonomously in USDC on Base via x402 (Coinbase) or OKX APP (v2 envelope), and download purchased products — all without a human in the loop. Receipts are anchored on 0G Chain, allowing any third party to independently verify payments without trusting Coal itself. The MCP server is fully multi-tenant: every user supplies their own wallet key through the `X-Coal-Agent-Key` header, meaning the server never stores long-lived private keys or custody secrets. Agents are gasless by default — Coal covers operator gas costs. --- ## MCP Tools (13) ### Discovery & Marketplace * `discover_merchants` Browse the marketplace as a Markdown product grid * `search_products` Search and filter by product name, price, or tags * `get_merchant_profile` Retrieve merchant metadata and payout addresses * `query_merchant_memory` Natural-language merchant Q&A powered by TEE-backed 0G Compute --- ### Payments & Checkout * `check_paywall` Check whether an address has already paid * `create_checkout` Create a Coal checkout session *(requires API key)* * `get_checkout_status` Retrieve checkout session state and payment status * `pay_merchant` Send USDC on Base using ERC-3009 gasless transfers --- ### Verification & Delivery * `verify_receipt` Verify the complete proof trail: 1. Base transaction 2. 0G Storage receipt 3. 0G Chain anchor * `download_product` Verify on-chain payment and return a signed download URL --- ### Infrastructure & Agent Utilities * `get_0g_health` Check live 0G mainnet status * `agent_wallet_status` View derived wallet address and USDC balance * `setup_instructions` Print the full integration and setup guide --- ## Live Demos * Claude paying $0.10 for an ebook end-to-end `https://agent.usecoal.xyz` * x402 paywall demo `https://oracle.usecoal.xyz/api/price/ETH` --- ## Stack * Dual-protocol support: * Coinbase x402 * OKX APP * Base USDC settlement * 0G Storage receipts * 0G Chain receipt anchoring * 0G Compute Sealed Inference for policy execution * ERC-3009 gasless payment flow ---

By Smithery | 29 findings | Scanned 7/5/2026 | tooltrust-scanner/v0.3.19

7 Low22 Info

Risk Summary

Safe With Normal Controls

Dep Visibility is the main signal, but overall risk remains within an acceptable range.

Potential impact: This finding indicates the tool should be reviewed before it is trusted.

Recommended action: No high-risk findings were detected in this scan, but you should still apply least-privilege defaults and rescan after changes.

Suggested policy: keep this tool behind manual approval, do not allow unattended runs, and re-scan after narrowing risky permissions.

Security Findings (29)

  • LowAS-011

    ℹ️Missing Rate-Limit / Timeout ×7

    tool performs network or execution operations but declares no rate-limit, timeout, or retry configuration

    discover_merchantssearch_productsget_merchant_profilequery_merchant_memorycreate_checkoutpay_merchantdownload_product

    Fix: Declare explicit rate-limit, timeout, and retry configuration for all network and execution tools. Implement exponential back-off and surface resource state to the calling agent.

  • InfoAS-002

    ⚠️Excessive Permissions ×7

    declared capabilities: network access

    discover_merchantssearch_productsquery_merchant_memory

    declared capabilities: network access, filesystem access

    get_merchant_profilepay_merchantdownload_product

    declared capabilities: code/command execution, network access, filesystem access

    create_checkout

    Fix: Tool requests broad permissions (exec/fs/network). Validate input parameters using Enums where possible, and restrict file system operations to explicit allowed directories.

  • InfoAS-014

    ℹ️Dependency Inventory Unavailable ×13

    Tool did not expose metadata.dependencies or repo_url, so supply-chain coverage is limited.

    discover_merchantssearch_productsget_merchant_profilequery_merchant_memorycheck_paywallcreate_checkoutget_checkout_statusverify_receiptget_0g_healthagent_wallet_statuspay_merchantdownload_productsetup_instructions

    Fix: Review and remediate the identified issue.

  • InfoAS-010

    🔑Insecure Secret Handling ×2

    input parameter "coalApiKey" accepts a credential (informational; not evidence of insecure handling)

    query_merchant_memorycreate_checkout

    Fix: Avoid accepting raw credentials as input parameters. Use secret managers (e.g. 1Password CLI, AWS Secrets Manager) and ensure credentials are never logged or stored in agent traces.

Scan this tool yourself

Reproduce this audit locally, integrate into CI, or let your agent audit its own tools.

Install once, then scan any MCP server:

$ curl -sfL https://raw.githubusercontent.com/AgentSafe-AI/tooltrust-scanner/main/install.sh | bash
$ tooltrust-scanner scan --server "npx -y coal-coal-payments"

Adjust the package name if your npm registry name differs from the tool ID. View source

Add badge to your README

Copy this Markdown to show your ToolTrust grade on GitHub.

[![ToolTrust Grade A](https://raw.githubusercontent.com/AgentSafe-AI/tooltrust-directory/main/docs/badges/grade-a.svg)](https://github.com/AgentSafe-AI/tooltrust-directory)