The PayBot MCP Server enables AI agents to manage USDC payments and bot finances programmatically through the Model Context Protocol.
Make a Payment (
pay): Submit a USDC payment to a recipient wallet address, specifying an amount, optional memo/description, idempotency key (to prevent duplicates), bot identifier, and network.Check Payment Status (
get_payment): Retrieve the current status and details of a specific payment by its payment ID.List Recent Payments (
list_payments): View a paginated list of recent payments and audit events, with control over result count and offset.Check Bot Balance & Limits : Query a bot's trust level, spending limits, and remaining budget.
Register New Bots: Register a new bot with the facilitator using a unique identifier and optional initial trust level.
Health Check (
health): Verify that the PayBot server is reachable and operational.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PayBot MCP ServerSend 25 USDC to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e for the consultation."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
paybot-mcp
MCP server for PayBot — payment tools for AI agents via the Model Context Protocol.
Install
npm install paybot-mcp paybot-sdkUsage with Claude Desktop
Add 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"
}
}
}
}Usage with Claude Code
{
"mcpServers": {
"paybot": {
"command": "npx",
"args": ["paybot-mcp"],
"env": {
"PAYBOT_API_KEY": "pb_...",
"PAYBOT_BOT_ID": "my-agent"
}
}
}
}Environment Variables
Variable | Description | Default |
| PayBot API key | (required) |
| Facilitator server URL |
|
| Default bot identifier |
|
| Wallet private key for real payments | (optional) |
Available Tools
Tool | Description |
| Make a USDC payment for an API, service, or resource |
| Check trust level, spending limits, and remaining budget |
| View recent payment history and audit events |
| Register a new bot with the facilitator |
paybot_pay
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)paybot_balance
botId?: string - Bot identifier (defaults to env)paybot_history
botId?: string - Bot identifier (defaults to env)
limit?: number - Max events to return (default: 10)paybot_register
botId: string - Unique bot identifier
trustLevel?: number - Initial trust level 0-5 (default: 1)Programmatic Usage
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);License
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.