proxy-mcp

name	proxy-mcp
description	Proxy MCP server integration for AI agent payments. Use Proxy's Model Context Protocol tools to create payment intents, provision virtual cards, check balances, and track transactions. Requires Proxy account and agent token.

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

Code	Meaning
POLICY_REQUIRED	Agent needs policy assigned
ONBOARDING_INCOMPLETE	Complete KYC first
INSUFFICIENT_BALANCE	Add funds
AGENT_NOT_FOUND	Invalid token
FORBIDDEN	Permission denied
INTENT_NOT_FOUND	Bad intent ID
CARD_NOT_FOUND	Bad card ID

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