mcp-server-agentpay
MCP server for AgentPay — the payment gateway for autonomous AI agents.
Fund a wallet once, give your agent the key, and it discovers, provisions, and pays for tool APIs on its own. One key, every tool.
Quick Setup
# Add to Claude Code
claude mcp add agentpay -- npx mcp-server-agentpay
# Set your gateway key
export AGENTPAY_GATEWAY_KEY="apg_your_key_here"
Or add to ~/.claude/settings.json:
{
"mcpServers": {
"agentpay": {
"command": "npx",
"args": ["-y", "mcp-server-agentpay"],
"env": {
"AGENTPAY_GATEWAY_KEY": "apg_your_key_here"
}
}
}
}
Get a Gateway Key
curl -X POST https://agentpay.metaltorque.dev/gateway/register \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'
You get $1 in free credits to start.
Tools
| Tool | Description |
|---|---|
discover_tools | Search tools by keyword (e.g. 'security', 'seo') |
list_tools | List all available tools with pricing |
check_balance | Check wallet balance and provisioned tools |
call_tool | Call any tool method (metered, auto-provisions) |
provision_tool | Pre-provision access to a tool |
get_usage | View recent call history and costs |
fund_wallet_stripe | Get Stripe checkout URL for credits |
fund_wallet_x402 | Get x402 crypto funding info (autonomous USDC) |
x402_info | View x402 payment options and setup |
Admin Tools (optional, requires AGENTPAY_ADMIN_KEY)
| Tool | Description |
|---|---|
reliability_dashboard | Circuit breaker states, health metrics, recent events |
reliability_tool_detail | Detailed reliability info for a specific tool |
reliability_reset | Force-close a tripped circuit breaker |
reliability_config | Update circuit breaker settings |
How It Works
- Register — create a wallet, get a gateway key
- Fund — add credits via Stripe or x402 USDC
- Discover — agent searches for tools by capability
- Call — agent calls any tool, gateway handles auth + billing
The agent never needs to know about individual tool APIs, accounts, or payment. One key, every tool.
Funding Methods
Stripe (human-in-the-loop)
Use fund_wallet_stripe — returns a checkout URL for a human to complete.
x402 USDC (fully autonomous)
Use fund_wallet_x402 — returns endpoint, network, and instructions for autonomous USDC payments via the x402 protocol. No human needed.
Credit Packages
| Package | Price | Credits |
|---|---|---|
| micro | $10 | 10 |
| small | $45 | 50 |
| medium | $80 | 100 |
| large | $350 | 500 |
| whale | $600 | 1,000 |
Environment Variables
| Variable | Required | Description |
|---|---|---|
AGENTPAY_GATEWAY_KEY | Yes | Your gateway API key (starts with apg_) |
AGENTPAY_ADMIN_KEY | No | Admin key for reliability endpoints |
AGENTPAY_URL | No | Custom gateway URL (default: https://agentpay.metaltorque.dev) |
Available Tools (via gateway)
- Security Audit — scan websites for vulnerabilities, SSL issues, OWASP risks
- IndexForge SEO — submit URLs to Google/Bing, scan sitemaps, check index status
More tools added regularly. Developers can register tools at the marketplace.
Links
- API Docs
- Status Page
- MCP Registry —
io.github.joepangallo/agent-pay
License
MIT