# mcp-asaas

Connects the Asaas payment platform to your coding assistant for issuing Pix invoices, boletos, and recurring subscriptions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/asaas
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-asaas

## What it does

This integration grants coding assistants direct access to Asaas financial workflows. It provides 24 tools covering customer records, boleto barcode generation, static Pix QR codes, and card charges with installment splits. Assistants can also inspect account balances, trigger refunds, register subaccounts, and manage recurring plans.

The server runs via npx with `@codespar/mcp-asaas`. Live calls and testing against `sandbox.asaas.com` require your token in the `ASAAS_API_KEY` environment variable. Without a valid credential or the demo toggle active, remote API operations will immediately fail.

You can prototype locally without an account by enabling `MCP_DEMO=true` or passing the `--demo` argument. This fixture mode tracks newly generated payments in memory and previews multi-month installment schedules without contacting external servers.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ASAAS_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaas
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add asaas --env ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaas
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "asaas": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-asaas"
            ],
            "env": {
                "ASAAS_API_KEY": "<ASAAS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "asaas": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-asaas"
            ],
            "env": {
                "ASAAS_API_KEY": "<ASAAS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ASAAS_API_KEY=<ASAAS_API_KEY> asaas npx -y @codespar/mcp-asaas
```
Replace <…> with your own values

## When to use it
- issue invoices using Pix, boleto, or credit cards
- preview and calculate payment installment schedules
- create and cancel recurring billing subscriptions
- generate static Pix QR codes to accept incoming transfers
- review current balances and inspect webhook events

## Example prompts
- Generate a Pix QR code to receive a payment of 120 BRL
- Create a credit card payment split into 3 monthly installments
- Check the current Asaas account balance and list recent webhook notifications

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md