Proxy MCP Integration

Connect to Proxy's MCP server for AI agent payments.

MCP Server Setup

Option 1: NPX (Recommended)

{
  "mcpServers": {
    "proxy": {
      "command": "npx",
      "args": ["-y", "proxy-mcp-server"],
      "env": {
        "PROXY_AGENT_TOKEN": "your-agent-token"
      }
    }
  }
}

Option 2: HTTP Transport

{
  "mcpServers": {
    "proxy": {
      "transport": "http",
      "url": "https://api.proxy.app/mcp",
      "headers": {
        "Authorization": "Bearer your-agent-token"
      }
    }
  }
}

All 13 MCP Tools

User & Onboarding

• proxy.user.get - Get user profile and account info
• proxy.kyc.status - Check KYC verification status
• proxy.kyc.link - Get KYC completion URL

Balance & Funding

• proxy.balance.get - Get available spending power
• proxy.funding.get - Get ACH/wire/crypto deposit instructions

Intents (Core Flow)

• proxy.intents.create - Create payment intent (triggers card issuance)
• proxy.intents.list - List all intents for this agent
• proxy.intents.get - Get intent details including card info

Cards

• proxy.cards.get - Get card details (masked PAN)
• proxy.cards.get_sensitive - Get full card number, CVV, expiry

Transactions

• proxy.transactions.list_for_card - List transactions for a card
• proxy.transactions.get - Get detailed transaction info

Utility

• proxy.tools.list - List all available Proxy tools

Core Payment Flow

proxy.balance.get → proxy.intents.create → proxy.cards.get_sensitive → Pay

Error Response Format

{
  "success": false,
  "error": {
    "code": "POLICY_REQUIRED",
    "message": "No policy configured",
    "hint": "Assign a policy to this agent",
    "context": "intents.create"
  }
}

Error Codes

Getting Started

1. Sign up at proxy.app
2. Complete KYC verification
3. Create Agent in dashboard
4. Assign a Policy (spending limits)
5. Generate Agent Token
6. Add MCP config above