# PagSeguro — how to use (mcp.ai)

Pagamentos PagSeguro / PagBank, pedidos (orders), cobranças (consultar, cancelar, estornar), checkouts e chave pública via API oficial. Cole o token gerado em Venda Online → Integrações → Gerar Token no painel PagSeguro. Companheiro de recebíveis do Banco MCP (Open Finance).

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pagseguro?ms=1781351460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `pagseguro_charges_cancel`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pagseguro`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/pagseguro/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pagseguro/charges/cancel` — Cobranças (charges) no PagSeguro.
  - body: { charge_id: string, amount_cents?: integer, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/charges/get` — Cobranças (charges) no PagSeguro.
  - body: { charge_id: string, amount_cents?: integer, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/charges/refund` — Cobranças (charges) no PagSeguro.
  - body: { charge_id: string, amount_cents?: integer, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/checkouts/create` — Checkouts (links/sessões de pagamento) no PagSeguro.
  - body: { checkout_id?: string, checkout?: object, account?: string, checkout_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/checkouts/deactivate` — Checkouts (links/sessões de pagamento) no PagSeguro.
  - body: { checkout_id?: string, checkout?: object, account?: string, checkout_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/checkouts/get` — Checkouts (links/sessões de pagamento) no PagSeguro.
  - body: { checkout_id?: string, checkout?: object, account?: string, checkout_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/list/accounts` — Lista tokens PagSeguro (contas de merchant) vinculados a este install — id e label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/pagseguro/orders/create` — Pedidos (orders) no PagSeguro.
  - body: { order_id?: string, reference_id?: string, order?: object, account?: string, order_ids?: string[], reference_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/orders/get` — Pedidos (orders) no PagSeguro.
  - body: { order_id?: string, reference_id?: string, order?: object, account?: string, order_ids?: string[], reference_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/orders/list` — Pedidos (orders) no PagSeguro.
  - body: { order_id?: string, reference_id?: string, order?: object, account?: string, order_ids?: string[], reference_ids?: string[] }
- `POST https://api.mcp.ai/api/pagseguro/public/keys` — Retorna a chave pública do merchant (para criptografar cartão no client). type default 'card'.
  - body: { type?: string, account?: string }

## Example prompts
- "Consulte o pedido order_id X no PagSeguro"
- "Estorne a cobrança charge_id Y"
- "Crie um checkout de pagamento"

## More
- Page: https://mcp.ai/pagseguro
- Agent spec (llms.txt): https://mcp.ai/pagseguro/llms.txt
- Postman collection: https://mcp.ai/pagseguro/postman.json