Braspag

What your agent can do

Braspag gives your agent 22 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →create_sale — Create a sale on the Braspag Transaction API (POST /sales). Pass a full Braspag sale payload. Payment.Type may be CreditCard, DebitCard, Boleto, Pix, or EletronicTransfer. Braspag orchestrates routing across multiple acquirers based on merchant-level rules.
• →capture_sale — Capture a pre-authorized sale (PUT /sales/{paymentId}/capture). Supports partial capture via amount, and optional serviceTaxAmount (airline / travel merchants).
• →void_sale — Void / cancel a sale (PUT /sales/{paymentId}/void). Supports full void (omit amount) or partial void.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_sale", { /* ... */ });

Install

$ npm install @codespar/mcp-braspag

Quickstart

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

{
  "mcpServers": {
    "braspag": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-braspag"
      ],
      "env": {
        "BRASPAG_MERCHANT_ID": "<your_braspag_merchant_id>",
        "BRASPAG_MERCHANT_KEY": "<your_braspag_merchant_key>"
      }
    }
  }
}

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

Environment variables · 3

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

Available tools · 22

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

Compatible frameworks

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

Frequently asked questions