Pagar.me

v0.2.0API Key

Payment gateway with card, Pix, and boleto. Receivables anticipation and risk management built for Brazilian marketplaces.

22 tools2 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-pagar-me

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

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

After restart, your agent can call any of the 22 tools below — try create_order first.

Environment variables · 2

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

PAGARME_API_KEY

requiredsecret

Secret key (sk_xxx) for Pagar.me

PAGARME_PUBLIC_KEY

optional

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

Available tools · 22

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_order

Create an order in Pagar.me with items and payment

READget_order

Get order details by ID

READlist_orders

List orders with optional filters

WRITEcreate_charge

Create a charge (Pix, boleto, or credit card)

WRITEget_charge

Get charge details by ID

WRITEcreate_recipient

Create a recipient for split payments

READget_balance

Get current account balance

WRITEcreate_transfer

Create a transfer to a recipient

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.