mcp-asaas — Claude Code MCP server: what it does, how to install
Connects the Asaas payment platform to your coding assistant for issuing Pix invoices, boletos, and recurring subscriptions.
claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaasWhat mcp-asaas 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-asaas
Platform CLI
claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaasReplace <…> with your own values
Platform CLI
codex mcp add asaas --env ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaasReplace <…> with your own values
Config file
{
"mcpServers": {
"asaas": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-asaas"
],
"env": {
"ASAAS_API_KEY": "<ASAAS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"asaas": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-asaas"
],
"env": {
"ASAAS_API_KEY": "<ASAAS_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ASAAS_API_KEY=<ASAAS_API_KEY> asaas npx -y @codespar/mcp-asaasReplace <…> with your own values
Step 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 mcp-asaas
How do I install mcp-asaas in Claude Code?
Run claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaas. Substitute <ASAAS_API_KEY> with your personal key from the Asaas dashboard.
What does mcp-asaas do?
It equips language models with tools to handle Brazilian Asaas payment workflows. The assistant can automate boletos, schedule bank transfers, and create subscriptions directly during conversations.
Can I test mcp-asaas without an API token?
Yes, launch the package with --demo or set MCP_DEMO=true. It runs offline fixture handlers that simulate payment creation and installment calculations.
