Proxy MCP Integration

Connect to Proxy's MCP server for agent payments.

MCP server config

Agent token (autonomous)

{
  "mcpServers": {
    "proxy": {
      "type": "http",
      "url": "https://mcp.useproxy.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer $PROXY_AGENT_TOKEN"
      }
    }
  }
}

OAuth (interactive clients)

Add the MCP server and run your client's OAuth login flow. OAuth is for interactive clients (Codex, Claude, Cursor).

Core flow (agent token)

proxy.kyc.status
proxy.balance.get
proxy.policies.simulate (optional)
proxy.intents.create
if approvalRequired/pending_approval -> proxy.intents.request_approval
proxy.cards.get_sensitive (include intentId + reason)
proxy.transactions.list_for_card

Agent-token tools (autonomous)

• proxy.user.get
• proxy.kyc.status
• proxy.kyc.link
• proxy.policies.get
• proxy.policies.simulate
• proxy.balance.get
• proxy.tools.list
• proxy.intents.create (agent token required)
• proxy.intents.list
• proxy.intents.get
• proxy.intents.request_approval
• proxy.intents.approval_status
• proxy.cards.get_sensitive
• proxy.transactions.list_for_card
• proxy.transactions.get
• proxy.receipts.attach
• proxy.evidence.list_for_intent
• proxy.merchants.resolve
• proxy.mcc.explain (advisory)
• proxy.merchants.allowlist_suggest (advisory)

Human-only tools (blocked for agent tokens)

• proxy.funding.get
• proxy.cards.list
• proxy.cards.get
• proxy.cards.freeze
• proxy.cards.unfreeze
• proxy.cards.rotate
• proxy.cards.close
• proxy.intents.approve
• proxy.intents.reject
• proxy.webhooks.list
• proxy.webhooks.test_event

Approval behavior

• Approval is required only when policy.requireApproval is true and the amount exceeds autoApproveBelow.
• Agents should call proxy.intents.request_approval only when needed.

Notes

• Intents are required for every purchase. Cards stay locked between intents.
• Merchant/MCC rules are advisory unless issuer-level controls are enabled.
• proxy.cards.get_sensitive requires intentId and a clear reason; avoid logging PAN/CVV.
• Amounts are in cents; formatted fields are provided for display where applicable.

Error format

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