A
licenseC
qualityC
maintenanceMCP 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
54
1
MIT
obolpay-x402-mcp
This server enables AI agents to autonomously discover, evaluate, purchase, and manage access to premium data via USDC micropayments on Base mainnet, using the HTTP 402 payment protocol. It supports both on-chain payments and gasless transactions via prepaid balances.
Discover: Retrieve the gateway's machine-readable service manifest (price, token, network, recipient, capabilities) — no payment required.
Preview: Fetch a free data sample and the current payment challenge/invoice to evaluate quality before committing — no payment required.
Purchase: Make a one-shot on-chain USDC payment on Base to unlock the full dataset and receive a signed proof-of-purchase receipt.
Top Up: Credit a prepaid balance by providing the transaction hash of an on-chain USDC deposit, enabling future gasless calls.
Check Balance: Query a wallet's prepaid balance, remaining calls, and next nonce.
Spend Gasless: Fetch paid data by drawing from a prepaid balance — no on-chain transaction, no gas fees. Ideal for repeated use after a one-time top-up.
Verify Receipt: Verify a proof-of-purchase receipt by confirming it was signed by the server — open to anyone, no payment required.
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
📖 Tutorial: 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.
Give any MCP-compatible agent (Claude Desktop, etc.) the ability to discover → evaluate (free preview) → pay once → then call GASLESS forever → verify a signed receipt — autonomously.
🚀 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)Then buy today's verifiable openunit value with one signed USDC micropayment
(buy_openunit.py), or drop it into a LangChain/any-LLM agent as a
tool (agent_tool.py). Full walkthrough: examples/README.md.
Related MCP server: @true402.dev/mcp-server
Tools
Tool | What it does |
| Machine-readable service manifest (price, token, network, capabilities) |
| Free data sample + price from the 402 challenge (no spend) |
| One-shot on-chain pay-and-fetch |
| Fund a prepaid balance from a USDC deposit (once) |
| Balance, calls remaining, next nonce |
| Instant, gasless pay-per-call from the prepaid balance (no on-chain tx/gas) |
| Third-party verify a proof-of-purchase receipt |
Why it's different
Free preview before paying — evaluate the data, no blind spend.
Prepaid GASLESS balance — deposit USDC once, then unlimited cheap calls via off-chain signed vouchers.
Signed receipts — EIP-191 proof-of-purchase, verifiable at
/verify-receipt.Freshness SLA + auto-refund — stale data is auto-refunded to your balance.
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://x402.obolpay.xyz (default)
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://x402.obolpay.xyz
Discovery manifest: https://x402.obolpay.xyz/.well-known/x402
Reference client (non-MCP): https://x402.obolpay.xyz/client.py
Built on x402 + Base. USDC micropayments for the AI agent economy.
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Tools
Related MCP Servers
- AlicenseAqualityAmaintenanceAn 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.14337MIT
- Alicense-qualityDmaintenanceMCP server for the x402 protocol that lets AI agents discover and call payment-gated HTTP APIs automatically.185Apache 2.0
mpp32-mcp-serverofficial
Alicense-qualityBmaintenanceMCP 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.236MIT
Related MCP Connectors
Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.
MCP marketplace: agents pay per call in USDC via x402. Plus Base chain data and a USDC<->bank ramp.
Agent x402 Paywall MCP — Coinbase HTTP 402 protocol + on-chain settlement. Agents pay per-call
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Hiroshi-Ichiyanagi/obolpay-x402-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server