---
name: paybox
description: Connect an AI agent to PayBox to use user-approved wallets, cards, and secrets without accessing raw credentials.
---

# PayBox agent integration

Connect to `https://api.paybox.sh/mcp`. The MCP server starts OAuth 2.1 with PKCE and requires the user to approve credential access in PayBox.

## Use

1. Add the MCP URL to the agent client.
2. Complete the browser authorization flow.
3. Call MCP tools after the client receives an access token.
4. If an operation returns `pending_approval`, direct the user to its approval URL and poll `get_request`.

Use [the MCP tools reference](https://docs.paybox.sh/reference/mcp-tools) for tool arguments and outputs. Use [the API reference](https://docs.paybox.sh/api-reference) for OAuth endpoints.

## Safety

PayBox grants are scoped and revocable. Never ask a user to provide a private key, card number, password, or API key in a tool input.