Quick Start

Get started with CyberPay MCP Server in 5 minutes.

1. Get API Key

2. Configure MCP

Claude Desktop

Edit ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cyberpay": {
      "command": "npx",
      "args": ["@cyberpay/mcp"],
      "env": {
        "CYBERPAY_API_KEY": "cp_your_api_key"
      }
    }
  }
}

Cursor

Add in Cursor Settings → MCP:

{
  "cyberpay": {
    "command": "npx",
    "args": ["@cyberpay/mcp"],
    "env": {
      "CYBERPAY_API_KEY": "cp_your_api_key"
    }
  }
}

Kiro

Edit .kiro/settings/mcp.json:

{
  "mcpServers": {
    "cyberpay": {
      "command": "npx",
      "args": ["@cyberpay/mcp"],
      "env": {
        "CYBERPAY_API_KEY": "cp_your_api_key"
      }
    }
  }
}

3. Test It Out

Once configured, use natural language in your AI Agent:

Create a Virtual Card

"Create a $50 Visa virtual card for me"

The Agent will call the card-create service and return the card number, CVV, and expiry.

Get a Verification Code

"Get me a US phone number for Telegram registration"

The Agent will call the sms-number service, obtain a virtual number, and wait for the verification code.

Buy a Gift Card

"Buy me a $25 Amazon gift card"

The Agent will call giftcard-browse to find the product, then giftcard-buy to complete the purchase.

Send an Email

"Send an email to test@example.com from @cyberpay.org"

The Agent will call the resend-send service to send the email.

Batch Transfer

"Transfer 10 USDC to each of these 5 addresses"

The Agent will call payout-preview to preview fees, then payout-batch to execute after confirmation.

4. Service List

See the full 22 services at Service Catalog.

FAQ

MCP Server connection failed?

Verify npx is available: npx --version
Confirm API Key is correct
Restart your AI Agent client

Service call error?

Check API Key permissions
Confirm parameter format is correct
See API Reference