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.

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",
        "AGENTPAY_URL": "https://pay.leddconsulting.com"
      }
    }
  }
}

Get a Gateway Key

curl -X POST https://pay.leddconsulting.com/gateway/register \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

You get $1 in free credits to start.

Tools (13 total)

| Tool | Description | |------|-------------| | discover_tools | Search tools by keyword | | 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 | | x402_info | View x402 payment options and setup | | reliability_dashboard | Admin: view circuit breaker + health dashboard | | reliability_tool_detail | Admin: detailed reliability view per tool | | reliability_reset | Admin: force-close a tripped circuit | | reliability_config | Admin: update per-tool reliability settings |

The 4 reliability tools require AGENTPAY_ADMIN_KEY.

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 | Bonus | |---------|-------|---------|-------| | test | $1 | 1 | — | | starter | $25 | 25 | — | | pro | $100 | 103 | 3% | | scale | $500 | 525 | 5% |

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.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AGENTPAY_GATEWAY_KEY | Yes | Your gateway API key (starts with apg_) | | AGENTPAY_ADMIN_KEY | No | Admin key for reliability tools (reliability_*) | | AGENTPAY_URL | No | Custom gateway URL (default: https://pay.leddconsulting.com) |

Advanced optional toggles:

| Variable | Default | Description | |----------|---------|-------------| | AGENTPAY_ENABLE_ADMIN_TOOLS | true | Enable/disable reliability_* MCP tools | | AGENTPAY_ENFORCE_HOST_ALLOWLIST | false | Enforce host allowlist for AGENTPAY_URL | | AGENTPAY_ALLOWED_HOSTS | pay.leddconsulting.com,agentpay.leddconsulting.com,localhost,127.0.0.1 | Comma-separated allowlist used when enforcement is enabled | | AGENTPAY_SESSION_BUDGET | unset | Optional session spending cap in credits | | AGENTPAY_REAL_MONEY_WARNINGS | false | Use stricter warning text in paid-tool/funding descriptions |

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. Tool providers can register at the gateway.

Links

• GitHub
• API Docs — alias: https://agentpay.leddconsulting.com
• MCP Registry — io.github.joepangallo/agent-pay