@codespar/mcp-pagar-me

MCP server for Pagar.me — Stone ecosystem payments with orders, charges, and split payments

Quick Start

Claude Desktop

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

{
  "mcpServers": {
    "pagar-me": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagar-me"],
      "env": {
        "PAGARME_API_KEY": "sk_your-key"
      }
    }
  }
}

Claude Code

claude mcp add pagar-me -- npx @codespar/mcp-pagar-me

Cursor / VS Code

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

{
  "servers": {
    "pagar-me": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagar-me"],
      "env": {
        "PAGARME_API_KEY": "sk_your-key"
      }
    }
  }
}

Tools (22)

| Tool | Purpose | |---|---| | create_order | Create an order in Pagar.me with items and payment | | get_order | Get order details by ID | | list_orders | List orders with optional filters | | create_charge | Create a charge (Pix, boleto, or credit card) | | get_charge | Get charge details by ID | | create_recipient | Create a recipient for split payments | | get_balance | Get current account balance | | create_transfer | Create a transfer to a recipient | | refund | Refund a charge (full or partial) | | list_recipients | List recipients with optional filters | | create_anticipation | Request anticipation of receivables for a recipient (antecipação) | | get_anticipation | Get anticipation details by ID | | get_anticipation_limits | Get anticipation limits available for a recipient | | create_plan | Create a subscription plan | | update_plan | Update an existing subscription plan | | create_subscription | Create a recurring subscription for a customer | | cancel_subscription | Cancel a recurring subscription | | create_card_token | Tokenize a credit card (PCI-safe). | | create_withdrawal | Create a withdrawal (saque) transferring recipient balance to their registered bank account | | register_webhook | Register a webhook endpoint to receive event notifications | | capture_charge | Capture a pre-authorized charge (auth-then-capture flow). | | partial_refund | Refund a portion of a charge (explicit partial refund; |

Authentication

Pagar.me uses Basic Auth with the secret key (sk_xxx) as username and empty password.

Sandbox / Testing

Pagar.me provides test mode via the dashboard. Use a test-mode API key to avoid real charges.

Get your credentials

1. Go to Pagar.me Dashboard
2. Create an account
3. Get your secret key (sk_test_xxx for test mode)
4. Set the PAGARME_API_KEY environment variable

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PAGARME_API_KEY | Yes | Secret key (sk_xxx) from Pagar.me dashboard | | PAGARME_PUBLIC_KEY | No | Public key (pk_xxx) for create_card_token only |

Roadmap

v0.3 (planned)

• list_charges — List charges with filters
• list_subscriptions — List subscriptions
• list_plans — List plans
• batch_charges — Create multiple charges in a single request
• list_webhooks / delete_webhook — Full webhook management

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

Links

• Pagar.me Website
• Pagar.me API Documentation
• MCP Dev Brasil
• 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