@codespar/mcp-pagseguro

MCP server for PagSeguro/PagBank — orders, charges, Pix, boleto, and credit card payments

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pagseguro": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagseguro"],
      "env": {
        "PAGSEGURO_TOKEN": "your-token",
        "PAGSEGURO_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add pagseguro -- npx @codespar/mcp-pagseguro

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "pagseguro": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagseguro"],
      "env": {
        "PAGSEGURO_TOKEN": "your-token",
        "PAGSEGURO_SANDBOX": "true"
      }
    }
  }
}

Tools (24)

| Tool | Purpose | |---|---| | create_order | Create an order in PagSeguro (Pix, boleto, or credit card) | | get_order | Get order details by ID | | list_orders | List orders with optional filters | | create_charge | Create a standalone charge | | refund | Refund a charge (full or partial) | | get_pix_qrcode | Get Pix QR code payload and image for an order charge | | create_customer | Create a customer in PagSeguro | | get_balance | Get account balance | | create_subscription | Create a recurring subscription plan in PagSeguro | | list_subscriptions | List subscriptions with optional filters | | get_notifications | Get payment notification details by notification code | | create_split | Create a split payment configuration for marketplace transactions | | get_dispute | Get dispute/chargeback details by ID | | pay_order | Pay an existing order (attach a charge/payment to an order in CREATED state) | | get_charge | Get charge details by ID | | list_charges | List charges with optional filters | | capture_charge | Capture a pre-authorized credit card charge | | cancel_charge | Cancel a charge that has not yet been settled | | create_boleto | Create a boleto charge | | get_boleto | Get boleto charge details by ID | | get_public_keys | Get PagSeguro public key for card data encryption (type: card) | | create_payout | Create a payout/transfer to a bank account or Pix key | | create_webhook | Register an application webhook URL to receive event notifications | | list_webhooks | List registered application webhooks |

Authentication

PagSeguro uses a Bearer token for authentication. Generate your token from the PagBank developer portal.

Sandbox / Testing

PagSeguro provides a sandbox at sandbox.api.pagseguro.com. Set PAGSEGURO_SANDBOX=true to use it.

Get your credentials

1. Go to PagBank Developer Portal
2. Create a developer account
3. Generate your API token
4. Set the PAGSEGURO_TOKEN environment variable

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PAGSEGURO_TOKEN | Yes | Bearer token from PagBank | | PAGSEGURO_SANDBOX | No | Set to "true" for sandbox mode |

Roadmap

v0.2 (planned)

• create_subscription — Create a recurring subscription
• list_subscriptions — List all subscriptions with filters
• get_notifications — Get payment notifications/webhooks
• create_split — Create split payments between receivers
• get_dispute — Get dispute/chargeback details

v0.3 (planned)

• create_plan — Create a subscription plan
• get_installments — Get installment options for a payment
• batch_refunds — Process multiple refunds in a single request

Want to contribute? Open a PR or request a tool.

Links

• PagBank Website
• PagBank API Documentation
• MCP Dev LATAM
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT