Which integrations are available for this server?

Allows creation of instant PIX charges with auto-generated QR codes for Brazilian real-time payments via the Garu payment platform.

How do I use garu-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@garu-mcp Create a PIX charge of R$150" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

garu-mcp

Official

by Garu-Pagamentos

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@garuhq/mcp

npm version License: MIT

An MCP server for the Garu payment platform. Create charges, manage customers, and discover products — directly from any MCP client like Claude Desktop, Cursor, or Claude Code.

Features

PIX Charges — Create instant PIX charges with auto-generated QR codes for Brazilian real-time payments.
Boleto Charges — Generate boleto bancário payment slips.
Charge Management — List, retrieve, and refund charges (full or partial).
Products — List your seller's products and look them up by UUID — the same UUID accepted by the charge tools.
Customers — Create, list, get, update, and remove customers linked to your seller account.

Setup

Create a Garu account and get your API key at garu.com.br.

Usage

Claude Code

claude mcp add garu -e GARU_API_KEY=sk_live_xxx -- npx -y --package=@garuhq/mcp@latest garu-mcp

Cursor

Open the command palette and choose "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "garu": {
      "command": "npx",
      "args": ["-y", "--package=@garuhq/mcp@latest", "garu-mcp"],
      "env": {
        "GARU_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Windsurf

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "garu": {
      "command": "npx",
      "args": ["-y", "--package=@garuhq/mcp@latest", "garu-mcp"],
      "env": {
        "GARU_API_KEY": "sk_live_xxx"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "mcpServers": {
    "garu": {
      "command": "npx",
      "args": ["-y", "--package=@garuhq/mcp@latest", "garu-mcp"],
      "env": {
        "GARU_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Claude Desktop

Open Claude Desktop settings > "Developer" tab > "Edit Config".

{
  "mcpServers": {
    "garu": {
      "command": "npx",
      "args": ["-y", "--package=@garuhq/mcp@latest", "garu-mcp"],
      "env": {
        "GARU_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Codex

codex mcp add garu --env GARU_API_KEY=sk_live_xxx -- npx -y --package=@garuhq/mcp@latest garu-mcp

Tools

Products (5 tools)

Tool	Description
`list_products`	List your seller's products with pagination and search
`get_product`	Get a single product by UUID — the identifier accepted by the charge tools
`get_product_portal_config`	Read per-product portal customization (B2B2C). Returns `null` if unset — product falls back to seller-level config
`set_product_portal_config`	Upsert with merge: only fields provided are written. Pass `null` on a field to inherit from seller
`clear_product_portal_config`	Remove the per-product config; product falls back to seller-level config

Portal-config tools accept productId as either the product UUID (preferred — same id returned by list_products) or the legacy numeric id. UUID support added in Garu v0.10.0.
Use list_products to discover the UUID you'll pass to create_pix_charge or create_boleto_charge.
Per-product portal config is the B2B2C primitive: SaaS that models professionals/coaches/instructors as Products under one Seller can give each one custom branding (businessName, primaryColor, logoUrl) and policies on the customer payment page + /minha-area portal — all without fragmenting the seller's accounting.

Charges (5 tools)

Tool	Description
`create_pix_charge`	Create a PIX charge with QR code
`create_boleto_charge`	Create a boleto bancário charge
`list_charges`	List charges with pagination and filters
`get_charge`	Get charge details by ID (includes `status`)
`refund_charge`	Refund a charge (full or partial)

Customers (6 tools)

Tool	Description
`create_customer`	Create a customer linked to your seller account
`list_customers`	List customers with search and pagination
`get_customer`	Get customer details by ID
`update_customer`	Update customer information
`delete_customer`	Remove customer from your seller account
`set_customer_billing_email_override`	Override the billing-email used for that customer

Scheduled charges (13 tools)

Bill an existing customer on a future date — one-time or recurring with card tokenization.

Tool	Description
`create_scheduled_charge`	Schedule a future charge. `type='recurring'` enables silent-charge of saved card on cycle 2+. Optional `maxRecoveryDays` (1–365) caps how long past `dueDate` the recovery sweep keeps auto-billing a missed charge (default 14)
`list_scheduled_charges`	Paginated list with filters by status, type, due-date range, customer
`get_scheduled_charge`	Detail bundle: charge + event timeline + linked transactions
`mark_paid_scheduled_charge`	Mark a cycle paid (off-Garu reconciliation)
`charge_now_scheduled_charge`	Force-bill the current cycle now instead of waiting for the due date (same dispatch as the daily cron). Idempotent — reports `already_sent` rather than re-charging
`postpone_scheduled_charge`	Move next due date forward
`pause_scheduled_charge` / `resume_scheduled_charge`	Suspend / re-enable a series
`cancel_recurrence_scheduled_charge`	Hard-stop future cycles (recurring only)
`cancel_at_period_end_scheduled_charge`	Stripe-style soft-cancel; reversible
`change_scheduled_charge_payment_method`	Swap the saved card
`clear_scheduled_charge_payment_method`	Remove saved card; future cycles email-with-link
`list_scheduled_charge_attempts`	Per-attempt billing log (v0.8.2). Each row carries the canonical `failureCode` for declines — use this to debug recurring billing failures without joining Transactions

Resources

garu://docs/quickstart — Getting started guide
garu://docs/openapi — Link to the OpenAPI spec

Environment Variables

GARU_API_KEY — Your Garu API key (required). Get yours at garu.com.br.

Local Development

Clone and build:

git clone https://github.com/Garu-Pagamentos/garu-mcp.git
npm install
npm run build

To use the local build, replace the npx command with the path to your local build:

Claude Code:

claude mcp add garu -e GARU_API_KEY=sk_live_xxx -- node /absolute/path/to/garu-mcp/dist/index.js

Cursor / VS Code / Windsurf / Claude Desktop:

{
  "mcpServers": {
    "garu": {
      "command": "node",
      "args": ["/absolute/path/to/garu-mcp/dist/index.js"],
      "env": {
        "GARU_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Run tests:

npm test

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Garu-Pagamentos/garu-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server