Content
# mcp-server-agentpay
<a href="https://glama.ai/mcp/servers/@joepangallo/mcp-server-agentpay"><img width="380" height="200" src="https://glama.ai/mcp/servers/@joepangallo/mcp-server-agentpay/badge" alt="AgentPay MCP server" /></a>
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
```bash
# 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`:
```json
{
"mcpServers": {
"agentpay": {
"command": "npx",
"args": ["-y", "mcp-server-agentpay"],
"env": {
"AGENTPAY_GATEWAY_KEY": "apg_your_key_here"
}
}
}
}
```
## Get a Gateway Key
```bash
curl -X POST https://pay.leddconsulting.com/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
1. **Register** — create a wallet, get a gateway key
2. **Fund** — add credits via Stripe or x402 USDC
3. **Discover** — agent searches for tools by capability
4. **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](https://www.x402.org/). 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://pay.leddconsulting.com`) |
## 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](https://pay.leddconsulting.com/docs).
## Links
- [API Docs](https://pay.leddconsulting.com/docs)
- [Status Page](https://pay.leddconsulting.com/status)
- [MCP Registry](https://registry.modelcontextprotocol.io) — `io.github.joepangallo/agent-pay`
## License
MIT