MCP server for PayBot — payment tools for AI agents via the Model Context Protocol.
npm install paybot-mcp paybot-sdkAdd to claude_desktop_config.json:
{
"mcpServers": {
"paybot": {
"command": "npx",
"args": ["paybot-mcp"],
"env": {
"PAYBOT_API_KEY": "pb_...",
"PAYBOT_FACILITATOR_URL": "https://facilitator.paybot.dev",
"PAYBOT_BOT_ID": "my-agent"
}
}
}
}{
"mcpServers": {
"paybot": {
"command": "npx",
"args": ["paybot-mcp"],
"env": {
"PAYBOT_API_KEY": "pb_...",
"PAYBOT_BOT_ID": "my-agent"
}
}
}
}| Variable | Description | Default |
|---|---|---|
PAYBOT_API_KEY |
PayBot API key | (required) |
PAYBOT_FACILITATOR_URL |
Facilitator server URL | http://localhost:3000 |
PAYBOT_BOT_ID |
Default bot identifier | mcp-agent |
PAYBOT_WALLET_KEY |
Wallet private key for real payments | (optional) |
| Tool | Description |
|---|---|
paybot_pay |
Make a USDC payment for an API, service, or resource |
paybot_balance |
Check trust level, spending limits, and remaining budget |
paybot_history |
View recent payment history and audit events |
paybot_register |
Register a new bot with the facilitator |
amount: string - Amount in USD (e.g., "0.05")
recipient: string - Recipient wallet address (0x...)
resource: string - URL or description of what you're paying for
botId?: string - Bot identifier (defaults to env)
network?: string - Network CAIP-2 ID (default: Base Sepolia)
botId?: string - Bot identifier (defaults to env)
botId?: string - Bot identifier (defaults to env)
limit?: number - Max events to return (default: 10)
botId: string - Unique bot identifier
trustLevel?: number - Initial trust level 0-5 (default: 1)
import { createMcpServer } from 'paybot-mcp/server';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
const server = createMcpServer();
const transport = new StdioServerTransport();
await server.connect(transport);