Skip to main content
Glama

obolpay-x402-mcp

Listed on Glama

Status (2026-10-06): maintenance. Since 2026-09-24 the Obolpay gateway accepts payments only through the standard x402 exact scheme (EIP-3009 transferWithAuthorization). This package and the buy examples still use the older pay-then-unlock flow, so they cannot buy at the moment — they stop before sending any USDC, because the gateway no longer quotes a recipient for that flow. Prepaid top-ups (topup()) ended on 2026-09-24 as well. discover(), preview() and verify_receipt() still work. To buy, use a standard x402 client against https://pay.obolpay.xyz (the gateway's own reference client: https://pay.obolpay.xyz/client.py).

📖 Tutorial (written for the older prepaid flow — see the status note above): Let your AI agent autonomously buy data — x402 + gasless prepaid + MCP on Base

MCP server for the live Obolpay x402 gateway — pay-per-call premium data for AI agents, settled in USDC on Base mainnet via HTTP 402. Business use only (see the gateway's terms).

Give any MCP-compatible agent (Claude Desktop, etc.) the ability to discover → evaluate (free preview) → verify a signed receipt (buying: see the status note above).

🚀 Copy-paste examples (start here) → examples/

No MCP needed to try it. Zero setup, no wallet, stdlib only:

python3 examples/quickstart_preview.py   # evaluate the data QUALITY for free (trustless preview)

The buy examples (buy_openunit.py, agent_tool.py) use the older pay-then-unlock flow and cannot buy since 2026-09-24 (see the status note). Full walkthrough: examples/README.md.

Related MCP server: @true402.dev/mcp-server

Tools

Tool

What it does

Status (2026-10-06)

discover()

Machine-readable service manifest (price, token, network, capabilities)

works

preview()

Free data sample + price from the 402 challenge (no spend)

works

purchase()

One-shot on-chain pay-and-fetch

cannot buy since 2026-09-24 (stops before paying)

topup(tx_hash)

Fund a prepaid balance from a USDC deposit (once)

ended 2026-09-24 (the gateway answers 410)

balance(address)

Balance, calls remaining, next nonce

works — the balance now holds only SLA and warranty credits

spend_gasless()

Instant, gasless pay-per-call from the prepaid balance (no on-chain tx/gas)

spends SLA and warranty credits only

verify_receipt(message, signature)

Third-party verify a proof-of-purchase receipt

works

Why it's different

  • Free preview before paying — evaluate the data, no blind spend.

  • Signed receipts — EIP-191 proof-of-purchase, verifiable at /verify-receipt.

  • Freshness SLA — stale data earns a credit to a non-refundable, non-transferable account balance at the gateway (spendable via signed vouchers).

  • Delta delivery (X-Since-Seq) — only new items, saves your context tokens.

Run

pip install -r requirements.txt          # mcp[cli], web3, eth-account, requests
export X402_AGENT_PRIVATE_KEY=0x...       # a Base wallet with USDC + a little ETH for gas
# optional: export X402_BASE_URL=https://pay.obolpay.xyz   (the default https://x402.obolpay.xyz redirects there)
python x402_mcp_server.py

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "obolpay-x402": {
      "command": "python",
      "args": ["/absolute/path/to/x402_mcp_server.py"],
      "env": { "X402_AGENT_PRIVATE_KEY": "0x..." }
    }
  }
}

Built on x402 + Base. USDC micropayments for the AI agent economy.

Available Tools

1 tool
topupA

Credit a prepaid balance from an on-chain USDC deposit to the recipient. First send USDC to the recipient on Base, then call this with the tx_hash.

Inputs: tx_hash (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no risk of confusion or overlapping purposes.

    Naming Consistency5/5

    With a single tool, naming consistency is inherently maintained; the name 'topup' is concise and action-oriented.

    Tool Count2/5

    A single tool is insufficient for a payment-related server; essential operations like checking balance or initiating deposits are missing.

    Completeness2/5

    The tool requires prior on-chain USDC transfer but provides no tool for that step, leaving a critical gap in the workflow.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      MCP server bringing 100+ x402-paid APIs to AI agents (Claude, Cursor, MCP-aware clients). Auto-discovers tools from CDP Bazaar; handles USDC micropayments on Base.
      100
      83 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the x402 protocol that lets AI agents discover and call payment-gated HTTP APIs automatically.
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that allows AI agents to discover and pay for thousands of APIs (x402 on Solana/Base) using a single key, with automatic payment handling and a federated catalog of machine-payable endpoints.
      221
      MIT