# @garuhq/mcp

Source: https://glimind.com/server/npm%2F-garuhq%2Fmcp
Registry id: `npm/-garuhq/mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "garuhq-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@garuhq/mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add garuhq-mcp -- npx -y @garuhq/mcp
```

## Tools (30)

- `cancel_at_period_end_scheduled_charge`: Stripe-style soft-cancel; reversible
- `cancel_charge`: Cancel an unpaid charge by uuid
- `cancel_recurrence_scheduled_charge`: Hard-stop future cycles (recurring only)
- `change_scheduled_charge_payment_method`: Swap the saved card
- `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-chargin
- `clear_product_portal_config`: Remove the per-product config; product falls back to seller-level config
- `clear_scheduled_charge_payment_method`: Remove saved card; future cycles email-with-link
- `create_boleto_charge`: Create a boleto bancário charge
- `create_customer`: Create a customer linked to your seller account
- `create_pix_charge`: Create a PIX charge with QR code
- `create_scheduled_charge`: Schedule a future charge. type='recurring' enables silent-charge of saved card on cycle 2+. methods accepts pix_automatic (Pix Automático — recurring + productI
- `delete_customer`: Remove customer from your seller account
- `get_charge`: Get charge details by uuid (includes status)
- `get_customer`: Get customer details by ID
- `get_product`: Get a single product by UUID — the identifier accepted by the charge tools. pixAutomatic enables Pix Automático on the public subscription checkout
- `get_product_portal_config`: Read per-product portal customization (B2B2C). Returns null if unset — product falls back to seller-level config
- `get_scheduled_charge`: Detail bundle: charge + event timeline + linked transactions
- `list_charges`: List charges with pagination and filters
- `list_customers`: List customers with search and pagination
- `list_products`: List your seller's products with pagination and search. Each product carries the pixAutomatic flag
- `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 Transac
- `list_scheduled_charges`: Paginated list with filters by status, type, due-date range, customer
- `mark_paid_scheduled_charge`: Mark a cycle paid (off-Garu reconciliation)
- `pause_scheduled_charge`: Suspend a series
- `postpone_scheduled_charge`: Move next due date forward
- `refund_charge`: Refund a charge (full or partial, amount in reais)
- `resume_scheduled_charge`: Re-enable a series
- `set_customer_billing_email_override`: Override the billing-email used for that customer
- `set_product_portal_config`: Upsert with merge: only fields provided are written. Pass null on a field to inherit from seller
- `update_customer`: Update customer information

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
