io.github.codespar/mcp-pagar-me MCP Server

MCP server for Pagar.me, focused on Stone ecosystem payments. It covers orders, charges, recipients, transfers, plans, subscriptions, and webhooks, based on the provided server description. Topics include agentic-commerce, payments, Pix, open finance, and model-context-protocol, targeting AI agents and LLM tool integrations.

🛠️ Key Features

Orders
Charges
Recipients
Transfers
Plans and subscriptions
Webhooks

🚀 Use Cases

Integrating Pagar.me payment flows (orders and charges) into LLM tools
Automating payment-related workflows using MCP (including recipients and transfers)
Handling subscription and webhook events in an agentic system

⚡ Developer Benefits

MCP-compatible integration for “llm-tools” and “ai-agents”
Supports common payment domain concepts: payments, Pix, and open-finance

⚠️ Limitations

The provided excerpt only includes a partial “Quick Start” configuration and does not include full setup details beyond an environment variable name (PAGARME_API_KEY).

Quick Start

Claude Desktop

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

json

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

Claude Code

bash

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

Cursor / VS Code

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

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

capture_charge

Capture a pre-authorized charge (auth-then-capture flow).

partial_refund

Refund a portion of a charge (explicit partial refund;

Variable

Required

Description

PAGARME_API_KEY

Yes

Secret key (sk_xxx) from Pagar.me dashboard

PAGARME_PUBLIC_KEY

Public key (pk_xxx) for create_card_token only

Install

Configuration

Environment variables

PAGARME_API_KEYrequiredsecret

Secret key (sk_xxx) for Pagar.me

PAGARME_PUBLIC_KEY

Public key (pk_xxx) for card tokenization (required only for create_card_token)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-pagar-me": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-pagar-me@0.2.2"
      ],
      "env": {
        "PAGARME_API_KEY": "<YOUR_PAGARME_API_KEY>",
        "PAGARME_PUBLIC_KEY": "<YOUR_PAGARME_PUBLIC_KEY>"
      }
    }
  }
}

io.github.codespar/mcp-pagar-me