# Asaas

Connects Asaas digital banking and billing data to AI agents through the v3 REST API. Helps you inspect balances and overdue invoices in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 401 installs · ★ 4 repo stars
- Author: mcp-dir
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mcp-dir/asaas-mcp
- Updated: 2026-08-30
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/asaas

## What it does

This MCP server reads financial data from the Brazilian payment platform Asaas using its official v3 REST API (`api.asaas.com`). It lets your assistant check account balances and track incoming PIX payments. All operations are strictly read-only. The agent cannot modify records or trigger payouts.

Requests go through a discovery tool called `search_tools`. The backend server is hosted and proprietary. The repository provides open manifests and documentation under the MIT license. Without an API key from your Asaas settings, the server will reject queries.

## Requirements
- Remote server: `https://asaas-mcp--mcp-dir.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http asaas-mcp https://asaas-mcp--mcp-dir.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add asaas --url https://asaas-mcp--mcp-dir.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "asaas": {
            "url": "https://asaas-mcp--mcp-dir.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "asaas": {
            "type": "http",
            "url": "https://asaas-mcp--mcp-dir.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http asaas https://asaas-mcp--mcp-dir.run.tools
```

## When to use it
- check the current Asaas account balance
- find overdue invoices marked with `OVERDUE` status
- track incoming PIX transfers received this week
- inspect payment links and recurring subscriptions

## Example prompts
- What is my current Asaas account balance?
- List all unpaid invoices with OVERDUE status
- Show incoming PIX transfers received this week

## Similar
- [mcp-asaas](https://affpapa.org/en/nevibecode/mcp/mcp-asaas.md) — MCP server · ★ 279 repo stars
- [mcp-pagar-me](https://affpapa.org/en/nevibecode/mcp/mcp-pagar-me.md) — MCP server · ★ 279 repo stars
- [payment-async-flow](https://affpapa.org/en/nevibecode/skills/payment-async-flow.md) — skill · 1100 installs
- [pluggy-payments](https://affpapa.org/en/nevibecode/skills/pluggy-payments.md) — skill · 446 installs
- [Lunium — Brazilian PIX and stablecoin payments](https://affpapa.org/en/nevibecode/mcp/lunium-brazilian-pix-and-stablecoin-payments.md) — MCP server
- [convex-billing](https://affpapa.org/en/nevibecode/skills/convex-billing.md) — skill · 43800 installs

---
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
