Asaas — Claude Code MCP server: what it does, how to install
Connects Asaas digital banking and billing data to AI agents through the v3 REST API. Helps you inspect balances and overdue invoices in chat.
MIT 401 installs ★ 4 updated 2026-08-30
claude mcp add --transport http asaas-mcp https://asaas-mcp--mcp-dir.run.toolsWhat Asaas 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.
What it helps with
- check the current Asaas account balance
- find overdue invoices marked with
OVERDUEstatus - track incoming PIX transfers received this week
- inspect payment links and recurring subscriptions
Example prompts for the agent
- What is my current Asaas account balance?
- List all unpaid invoices with OVERDUE status
- Show incoming PIX transfers received this week
How to install Asaas
Platform CLI: remote server
claude mcp add --transport http asaas-mcp https://asaas-mcp--mcp-dir.run.toolsPlatform CLI: remote server
codex mcp add asaas --url https://asaas-mcp--mcp-dir.run.toolsConfig file
{
"mcpServers": {
"asaas": {
"url": "https://asaas-mcp--mcp-dir.run.tools"
}
}
}Config file
{
"servers": {
"asaas": {
"type": "http",
"url": "https://asaas-mcp--mcp-dir.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http asaas https://asaas-mcp--mcp-dir.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Asaas
How do I install Asaas in Claude Code?
Run claude mcp add --transport http asaas-mcp https://asaas-mcp--mcp-dir.run.tools. This connects the remote HTTP server to Claude Code.
What does the Asaas MCP server do?
It provides read-only access to your Asaas digital account using the v3 REST API. Your assistant can check balances, list PIX transfers, and audit invoices.
Can this server process charges or transfers?
No, it functions strictly in read-only mode. None of the exposed tools can move funds or edit existing billing records.