/install agentpay-mcp
AgentPay MCP
Payment layer for AI agents via Model Context Protocol. AgentPay MCP gives your AI agent the ability to make payments, track spending, and manage payment channels -- without leaving the agent runtime.
Works with Claude Desktop, Cursor, Cline, Windsurf, and any MCP-compatible environment.
What It Does
- Make payments: Send USDC on Polygon directly from agent tool calls
- Budget management: Hard spending limits enforced per-session and per-day
- Payment channels: Open Handshake58-style channels for sub-cent micropayments
- CCTP bridge: Cross-chain USDC settlement (Ethereum, Base, Polygon, Arbitrum)
- Non-custodial: Agent holds its own keys -- no third-party custody
Installation
npm install -g agentpay-mcp
Add to your MCP config (~/.config/claude/mcp.json or equivalent):
{
"mcpServers": {
"agentpay": {
"command": "agentpay-mcp",
"env": {
"AGENT_PRIVATE_KEY": "0x...",
"RPC_URL": "https://polygon-rpc.com",
"MAX_TX_USDC": "25",
"MAX_DAILY_USDC": "500"
}
}
}
}
Tools Exposed
| Tool | Description |
|---|---|
pay |
Send USDC to an address (enforces spend limits) |
check_balance |
Query agent wallet balance |
get_spending |
Current session and daily spend totals |
open_channel |
Open a micropayment channel (Handshake58 compatible) |
pay_channel |
Issue a signed payment voucher (zero gas) |
close_channel |
Settle and reclaim unused channel funds |
bridge_usdc |
Cross-chain USDC via CCTP |
Usage Example
In Claude Desktop with AgentPay MCP configured:
"Pay 5 USDC to 0xABC...123 for the API call results"
The agent calls pay(to="0xABC...123", amount=5, token="USDC"). If within limits, it executes immediately. If over limits, it returns a request for human approval.
Environment Variables
| Variable | Required | Description |
|---|---|---|
AGENT_PRIVATE_KEY |
Yes | Agent's signing key (0x-prefixed) |
RPC_URL |
Yes | Polygon JSON-RPC endpoint |
MAX_TX_USDC |
No | Per-transaction limit in USDC (default: 25) |
MAX_DAILY_USDC |
No | Daily spending limit in USDC (default: 500) |
GitHub
https://github.com/AI-Agent-Economy/agentpay-mcp
License
MIT
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agentpay-mcp - After installation, invoke the skill by name or use
/agentpay-mcp - Provide required inputs per the skill's parameter spec and get structured output
What is AgentPay MCP?
MCP server that gives AI agents the ability to make payments, manage budgets, and handle billing -- directly from Claude Desktop, Cursor, Cline, or any MCP-c... It is an AI Agent Skill for Claude Code / OpenClaw, with 299 downloads so far.
How do I install AgentPay MCP?
Run "/install agentpay-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AgentPay MCP free?
Yes, AgentPay MCP is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AgentPay MCP support?
AgentPay MCP is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AgentPay MCP?
It is built and maintained by up2itnow (@up2itnow); the current version is v1.0.0.