Pay Mcp
Plugs USDC payments on Base directly into Claude Desktop, Cursor, or any MCP client. Handles direct transfers, metered tabs for per-call billing, and automatic x402 paywall detection with HTTP requests. The server auto-generates a wallet on first run and stores it in your OS keychain, so there's no manual key management. You get 15 tools covering send/request operations, tab lifecycle (open, charge, close, topup), wallet funding and withdrawal, service discovery, and webhook registration for payment events. Useful if you're building agents that need to pay for third-party APIs or accept payments themselves. Works on Base mainnet or Sepolia testnet with a one-line config change.
- tools
- 15
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Apr 17, 2026
Tools
15 toolsPublic tool metadata for what this MCP can expose to an agent.
pay_sendDirect USDC payment ($1 min). Confirmation thresholds: <$10 auto, $10-100 plan, >$100 explicit.
Direct USDC payment ($1 min). Confirmation thresholds: <$10 auto, $10-100 plan, >$100 explicit.
No parameter schema in public metadata yet.
pay_requestHTTP request with x402 auto-payment. Handles 402 detection, direct/tab settlement, price skepticism.
HTTP request with x402 auto-payment. Handles 402 detection, direct/tab settlement, price skepticism.
No parameter schema in public metadata yet.
pay_tab_openOpen pre-funded tab ($5 min, $50 recommended). Provider charges per-call.
Open pre-funded tab ($5 min, $50 recommended). Provider charges per-call.
No parameter schema in public metadata yet.
pay_tab_closeClose tab. Returns distribution breakdown (provider 99%, fee 1%, agent remainder).
Close tab. Returns distribution breakdown (provider 99%, fee 1%, agent remainder).
No parameter schema in public metadata yet.
pay_tab_chargeCharge against open tab (provider only).
Charge against open tab (provider only).
No parameter schema in public metadata yet.
pay_tab_topupAdd funds to open tab (agent only).
Add funds to open tab (agent only).
No parameter schema in public metadata yet.
pay_tab_listList tabs with idle/low-balance flags.
List tabs with idle/low-balance flags.
No parameter schema in public metadata yet.
pay_statusBalance, locked/available funds, actionable suggestions.
Balance, locked/available funds, actionable suggestions.
No parameter schema in public metadata yet.
pay_fundGenerate 1-hour funding link (Coinbase Onramp or direct USDC).
Generate 1-hour funding link (Coinbase Onramp or direct USDC).
No parameter schema in public metadata yet.
pay_withdrawGenerate 1-hour withdrawal link.
Generate 1-hour withdrawal link.
No parameter schema in public metadata yet.
pay_mintMint testnet USDC (Base Sepolia only).
Mint testnet USDC (Base Sepolia only).
No parameter schema in public metadata yet.
pay_discoverSearch paid API services by keyword/category.
Search paid API services by keyword/category.
No parameter schema in public metadata yet.
pay_webhook_registerRegister webhook for payment events (HMAC-signed).
Register webhook for payment events (HMAC-signed).
No parameter schema in public metadata yet.
pay_webhook_listList registered webhooks.
List registered webhooks.
No parameter schema in public metadata yet.
pay_webhook_deleteDelete a webhook.
Delete a webhook.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
PAYSKILL_SIGNER_KEYsecretPrivate key hex for importing an existing wallet (optional — generates new wallet if not set)
PAY_NETWORKNetwork to use: mainnet or testnet (default: mainnet)
Readme
@pay-skill/mcp
MCP server for Pay -- the complete x402 payment stack for AI agents. USDC on Base.
Gives any MCP-compatible client (Claude Desktop, Cursor, VS Code, custom frameworks) the full power of Pay: direct payments, tabs, x402 paywalls, service discovery, and wallet management. No CLI binary needed.
Setup
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"pay": {
"command": "npx",
"args": ["-y", "@pay-skill/mcp"]
}
}
}
VS Code / Cursor
Add to .vscode/mcp.json:
{
"servers": {
"pay": {
"command": "npx",
"args": ["-y", "@pay-skill/mcp"]
}
}
}
Claude Code
claude mcp add pay -- npx -y @pay-skill/mcp
That's it. On first run, the server generates a wallet and stores it in the OS keychain (Windows Hello, macOS Keychain, Linux Secret Service). Subsequent runs load it automatically.
Configuration
Details
- Repository
- github.com/pay-skill/pay-mcp
- Package
@pay-skill/mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active