Payoza MCP Server
MCP (Model Context Protocol) server that exposes the Payoza crypto payments API to AI assistants like Claude, Cursor, and Windsurf.
Setup
cd mcp
npm install
npm run build
Environment Variables
| Variable | Required | Default | Description |
|---|
PAYOZA_API_URL | No | http://localhost:8080 | Payoza API base URL |
PAYOZA_API_TOKEN | Yes | — | JWT bearer token |
PAYOZA_TEAM_ID | Yes | — | Team ID for scoped requests |
Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"payoza": {
"command": "node",
"args": ["/path/to/mcp/dist/index.js"],
"env": {
"PAYOZA_API_URL": "https://api.payoza.io",
"PAYOZA_API_TOKEN": "your-jwt-token",
"PAYOZA_TEAM_ID": "your-team-id"
}
}
}
}
Claude Code Configuration
claude mcp add payoza -- node /path/to/mcp/dist/index.js
Or add to .claude/settings.json:
{
"mcpServers": {
"payoza": {
"command": "node",
"args": ["/path/to/mcp/dist/index.js"],
"env": {
"PAYOZA_API_URL": "https://api.payoza.io",
"PAYOZA_API_TOKEN": "your-jwt-token",
"PAYOZA_TEAM_ID": "your-team-id"
}
}
}
}
Available Tools (38 total)
Overview
| Tool | Description |
|---|
get_overview | High-level account overview: balances, transaction/link/customer counts |
Payment Links
| Tool | Description |
|---|
list_payment_links | List payment links with pagination |
create_payment_link | Create a new payment link |
update_payment_link | Update a payment link |
delete_payment_link | Delete a payment link |
Checkout Sessions
| Tool | Description |
|---|
list_checkout_sessions | List checkout sessions with pagination |
create_checkout_session | Create a new checkout session |
get_checkout_session | Get checkout session details by ID |
Customers
| Tool | Description |
|---|
list_customers | List customers with pagination |
create_customer | Create a new customer |
get_customer | Get customer details by ID |
update_customer | Update a customer |
Transactions
| Tool | Description |
|---|
list_transactions | List transactions with pagination |
get_transaction | Get transaction details by ID |
Subscriptions
| Tool | Description |
|---|
list_subscriptions | List subscriptions with pagination |
get_subscription | Get subscription details by ID |
pause_subscription | Pause an active subscription |
resume_subscription | Resume a paused subscription |
cancel_subscription | Cancel a subscription |
Balance
| Tool | Description |
|---|
get_balances | Get balances across all currencies/chains |
get_balance_ledger | Get paginated ledger entries |
Settlements
| Tool | Description |
|---|
list_settlements | List settlements with pagination |
Webhooks
| Tool | Description |
|---|
list_webhooks | List configured webhooks |
create_webhook | Create a webhook endpoint |
update_webhook | Update a webhook |
get_webhook_events | Get delivery events for a webhook |
delete_webhook | Delete a webhook |
Prices
| Tool | Description |
|---|
get_exchange_rate | Get exchange rate between two currencies |
get_prices | Get prices for multiple tokens |
Analytics
| Tool | Description |
|---|
get_revenue_analytics | Get daily revenue analytics data |
get_platform_fee_analytics | Get platform fee analytics data |
Addresses
| Tool | Description |
|---|
list_addresses | List deposit addresses |
create_address | Create a deposit address for a chain |
Notifications
| Tool | Description |
|---|
list_notifications | List notifications with pagination |
get_unread_notification_count | Get unread notification count |
mark_notification_read | Mark a notification as read |
mark_all_notifications_read | Mark all notifications as read |
delete_notification | Delete a notification |
Team Members
| Tool | Description |
|---|
list_team_members | List team members |
invite_team_member | Invite a new member |
update_team_member | Update a member's role |
remove_team_member | Remove a team member |
API Keys
| Tool | Description |
|---|
list_api_keys | List API keys |
create_api_key | Create a new API key |
delete_api_key | Delete an API key |
Available Resources
| URI | Description |
|---|
payoza://team/info | Current authenticated user/team information |
payoza://docs/api | API documentation summary |
Supported Chains
solana · ethereum · base · polygon · bsc · arbitrum · avalanche
Supported Tokens
SOL · ETH · BTC · USDC · USDT · DAI and more depending on chain configuration.
Development
npm run dev # Run with tsx (no build step)
npm run typecheck # Type-check without emitting
npm run build # Compile to dist/
npm start # Run compiled output