Mcp Asaas

io.github.codesparPublished by GitHub account codesparv0.2.1Updated Oct 24, 2026

MCP server for Asaas — billing automation, Pix, boleto, credit card, subscriptions

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for the Asaas Brazilian payment platform, letting an assistant create and manage payments, Pix charges, boletos, subscriptions and transfers.

What you can do
  • Create, read, update, delete and refund payments, including Pix, boleto and credit card with installments
  • Fetch Pix QR codes and boleto digitable lines and barcodes for a payment
  • Create and list customers, and look up customer details
  • Create, list, get and cancel recurring subscriptions
  • Check account balance, create subaccounts for payment splitting, and create or list bank transfers (Pix out or TED)
  • List webhook events and create or list webhook notification configurations
When to use it
Useful when an assistant should handle Asaas billing work directly: issuing charges, checking payment status, managing subscriptions and customers, or reviewing transfers and webhook events. Demo mode lets you build and test agents without real credentials.
Requirements
Runs locally via npx (Node.js). Requires an Asaas account and an API key in the ASAAS_API_KEY environment variable, unless demo mode is used (--demo flag or MCP_DEMO=true). Optional ASAAS_SANDBOX=true points it at the Asaas sandbox. Network access to Asaas is needed.
Before you install
The API key in ASAAS_API_KEY grants access to a real payment account. Many tools move money or change records: create_payment, create_transfer, refund_payment, cancel_subscription, delete_payment and update_payment. Test with ASAAS_SANDBOX or demo mode first, and review any agent action that charges, refunds or transfers funds.

Installation

In SourceWeft

  1. Open Mcp Asaas in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-asaas

MCP server for Asaas — billing automation with Pix, boleto, and credit card payments

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "asaas": {      "command": "npx",      "args": ["-y", "@codespar/mcp-asaas"],      "env": {        "ASAAS_API_KEY": "your-key",        "ASAAS_SANDBOX": "true"      }    }  }}

Claude Code

bash
claude mcp add asaas -- npx @codespar/mcp-asaas

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "asaas": {      "command": "npx",      "args": ["-y", "@codespar/mcp-asaas"],      "env": {        "ASAAS_API_KEY": "your-key",        "ASAAS_SANDBOX": "true"      }    }  }}

Tools (24)

ToolPurpose
create_paymentCreate a payment in Asaas (Pix, boleto, or credit card); pass installments (>=2) with billingType: CREDIT_CARD to split into equal monthly installments
get_paymentGet payment details by ID
list_paymentsList payments with optional filters
get_pix_qrcodeGet Pix QR code for a payment (returns payload and image)
get_boletoGet boleto digitable line and barcode for a payment
create_customerCreate a customer in Asaas
list_customersList customers with optional filters
create_subscriptionCreate a recurring subscription
get_balanceGet current account balance
list_subscriptionsList subscriptions with optional filters
cancel_subscriptionCancel a subscription by ID
get_webhook_eventsList webhook events (payment confirmations, transfers, etc.)
create_subaccountCreate a subaccount for payment splitting
get_installmentsGet installment details for an existing payment by id, OR preview a hypothetical schedule by passing value + installments without an id
create_transferCreate a bank transfer (Pix out or TED)
create_pix_qrcodeGenerate a static PIX QR code for receiving payments
list_transfersList transfers with optional filters
create_notificationCreate a webhook notification configuration
list_notificationsList webhook notification configurations
get_customerGet customer details by ID
update_paymentUpdate a pending payment
delete_paymentDelete a payment by ID
refund_paymentRefund a received payment
get_subscriptionGet subscription details by ID

Authentication

Asaas uses an API key passed via the access_token header. You can generate your key from the Asaas dashboard.

Sandbox / Testing

Asaas provides a full sandbox environment at sandbox.asaas.com. Set ASAAS_SANDBOX=true to use it.

Get your credentials

  1. Go to Asaas
  2. Create an account or sign up for sandbox at sandbox.asaas.com
  3. Navigate to Integracoes > API and generate your API key
  4. Set the ASAAS_API_KEY environment variable

Environment Variables

VariableRequiredDescription
ASAAS_API_KEYYes (unless in demo mode)API key from Asaas dashboard
ASAAS_SANDBOXNoSet to "true" for sandbox mode
MCP_DEMONoSet to "true" (equivalent to passing --demo on the command line) for stateful demo-mode fixtures — no API key required

Demo mode

Pass the --demo flag (or set MCP_DEMO=true) to make every tool return deterministic fixture responses instead of calling the real Asaas API. Useful for building and testing agents without burning sandbox credentials.

The demo handlers for create_payment and get_installments are stateful: create_payment issues distinct ids per call (pay_demo_001, pay_demo_002, ...) and, when called with billingType: CREDIT_CARD + installments >= 2 + value > 0, records the installment schedule in an in-process ledger. A subsequent get_installments({ id }) against that id echoes the recorded schedule back. get_installments also supports a preview path — pass value + installments without an id and it returns a hypothetical schedule (status: "PREVIEW", preview: true) without creating a payment. Other tools return static fixture payloads.

bash
# Start the server in demo mode (no key required):npx -y @codespar/mcp-asaas --demo

Roadmap

v0.2 (planned)

  • list_subscriptions — List all recurring subscriptions with filters
  • cancel_subscription — Cancel an active subscription
  • get_webhook_events — List webhook events for debugging integrations
  • create_subaccount — Create a subaccount for marketplace splits
  • get_installments — Get installment details for a payment

v0.3 (planned)

  • create_anticipation — Request anticipation of receivables
  • get_fiscal_info — Get fiscal/tax information for payments
  • batch_payments — Create multiple payments in a single request

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/payments/asaas/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts