obolpay-x402-mcp
You can discover and preview Obolpay x402 paid data, verify receipts, and check/spend existing SLA/warranty credits—but purchases and top-ups are no longer functional.
discover(): read the gateway manifest (price, token, network, capabilities), no payment.preview(): get a free data sample plus the 402 price/invoice before deciding.verify_receipt(message, signature): verify an EIP-191 proof-of-purchase receipt with the gateway.balance(address): check prepaid balance, calls remaining, and next nonce; now only SLA/warranty credits.spend_gasless(): gasless spend from prepaid balance for paid data; only draws down SLA/warranty credits.purchase(): not usable since 2026-09-24; stops before sending USDC.topup(tx_hash): ended 2026-09-24; gateway returns 410.To actually buy now, use a standard x402
exactclient against https://pay.obolpay.xyz.
Provides a tool for LangChain agents to autonomously discover, preview, purchase, and consume premium data via gasless prepaid USDC micropayments on Base.
obolpay-x402-mcp
Status (2026-10-06): maintenance. Since 2026-09-24 the Obolpay gateway accepts payments only through the standard x402
exactscheme (EIP-3009transferWithAuthorization). 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()andverify_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) |
| Machine-readable service manifest (price, token, network, capabilities) | works |
| Free data sample + price from the 402 challenge (no spend) | works |
| One-shot on-chain pay-and-fetch | cannot buy since 2026-09-24 (stops before paying) |
| Fund a prepaid balance from a USDC deposit (once) | ended 2026-09-24 (the gateway answers 410) |
| Balance, calls remaining, next nonce | works — the balance now holds only SLA and warranty credits |
| Instant, gasless pay-per-call from the prepaid balance (no on-chain tx/gas) | spends SLA and warranty credits only |
| 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.pyClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"obolpay-x402": {
"command": "python",
"args": ["/absolute/path/to/x402_mcp_server.py"],
"env": { "X402_AGENT_PRIVATE_KEY": "0x..." }
}
}
}Links
Live endpoint: https://pay.obolpay.xyz (the old host x402.obolpay.xyz redirects here)
Discovery manifest: https://pay.obolpay.xyz/.well-known/x402
Reference client (non-MCP, standard
exactscheme): https://pay.obolpay.xyz/client.pyTerms · Pricing · Legal: https://pay.obolpay.xyz/terms · https://pay.obolpay.xyz/pricing · https://pay.obolpay.xyz/legal
Built on x402 + Base. USDC micropayments for the AI agent economy.
Available Tools
1 tooltopupA
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
Scored across 1 tool
Only one tool exists, so there is no risk of confusion or overlapping purposes.
With a single tool, naming consistency is inherently maintained; the name 'topup' is concise and action-oriented.
A single tool is insufficient for a payment-related server; essential operations like checking balance or initiating deposits are missing.
The tool requires prior on-chain USDC transfer but provides no tool for that step, leaving a critical gap in the workflow.
Maintenance
Related MCP Connectors
MCP server for X420's pay-per-call agent services (x402, USDC on Base, paid from your own wallet).
381x402 pay-per-call APIs over MCP, settled in USDC on Base for autonomous agents and developers.
Monetize any MCP server: x402 paywall, pay-per-call billing in USDC on Base, agent marketplace.
15 paid AI agent primitives via x402 (USDC on Base). Pay-per-call MCP server.
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP 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.10083 npm1MIT
- AlicenseAqualityBmaintenanceAn MCP server that enables AI agents to access paid AI inference and web tools via HTTP 402 micropayments in USDC on Base, using the agent's wallet as identity.36122 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the x402 protocol that lets AI agents discover and call payment-gated HTTP APIs automatically.Apache 2.0

mpp32-mcp-serverofficial
AlicenseNot gradedqualityDmaintenanceMCP 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.221MIT