Asaas

v0.1.2API 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

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)

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

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.