Skip to main content
AS

Asaas

v0.1.3API Key

Billing automation, Pix, boleto, credit card, and subscriptions. Your agent manages customers, creates recurring charges, and tracks payment status.

24 tools1 env varsπŸ‡§πŸ‡· Brazilstable on npm

What your agent can do

Asaas gives your agent 24 tools it calls directly β€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • create_payment β€” Create a payment in Asaas (Pix, boleto, or credit card). Pass `installments` (>=2) with `billingType: CREDIT_CARD` to split the value into equal monthly installments.
  • get_payment β€” Get payment details by ID
  • list_payments β€” List payments with optional filters
Example call
// Your agent calls a tool directly β€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-asaas

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "asaas": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-asaas"
      ],
      "env": {
        "ASAAS_API_KEY": "<your_asaas_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 24 tools below β€” try create_payment first.

Environment variables Β· 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

ASAAS_API_KEY
requiredsecret

API key for asaas

Available tools Β· 24

Each tool is independent β€” your agent loads only what it needs to reduce context and response time.

WRITEcreate_payment
Create a payment in Asaas (Pix, boleto, or credit card). Pass `installments` (>=2) with `billingType: CREDIT_CARD` to split the value into equal monthly installments.
WRITEget_payment
Get payment details by ID
WRITElist_payments
List payments with optional filters
READget_pix_qrcode
Get Pix QR code for a payment (returns payload and image)
READget_boleto
Get boleto digitable line and barcode for a payment
WRITEcreate_customer
Create a customer in Asaas
READlist_customers
List customers with optional filters
WRITEcreate_subscription
Create a recurring subscription

Compatible frameworks

MCP is a protocol β€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-asaas` and add the config block above to your MCP client β€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Asaas β€” MCP server Β· 24 tools | CodeSpar