# Asaas MCP for AI Agents AI Agent Connect

> Asaas lets you manage your Brazilian business's entire billing cycle through your AI client. You can register customers, generate PIX and Boleto payments, track recurring subscriptions, and monitor your balance in one place. It handles the heavy lifting of payment collection and financial oversight, allowing you to focus on growing your business without the manual overhead of constant dashboard switching.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_rcIKyAryOZBI6vsMm3cxduGKlH7f1q0t1XEHzxBU/ai-agent-connect
- **Tags:** billing-management, payment-gateway, subscription-management, financial-reporting, customer-inventory, pix-payments

## Description

Running a Brazilian business means jumping between multiple tabs to check if a PIX payment cleared, verifying CPF numbers for new clients, and manually tracking which subscriptions are still active. It's a constant cycle of copy-pasting data from your chat or email into a separate billing dashboard. This Connector changes that by giving your AI client a direct line to your Asaas account. Instead of jumping between tabs to check if a Boleto cleared or to see who's on an active subscription, you just ask your agent. You can have your AI register new clients with their tax IDs, generate instant payment links for your sales team, or pull a full list of your current receivables. It handles the tedious parts of the billing cycle, like verifying customer details or tracking transfers, while keeping everything organized in your primary workspace. By connecting this to your existing workflow through Vinkius, you turn a manual back-office process into a conversational one. You get a clear view of your financial health without the headache of manual exports or constant dashboard refreshes.

## Tools

### list_payments
View all your charges and payments. This helps you see what's been paid and what's still outstanding.

### create_customer
Register a new customer into your Asaas account. It makes onboarding new clients much faster.

### create_payment
Generate a new charge for a specific customer. Use this to send out PIX or Boleto requests.

### get_account_check
Verify that your AI client is correctly connected to Asaas. It's the quickest way to check your connection status.

### get_balance
See your current financial balance. This gives you an instant look at your available funds.

### list_customers
Pull a list of all your registered customers. It helps you keep track of your entire client base.

### list_subscriptions
See all your active recurring billings. This is perfect for tracking long-term service contracts.

### list_transfers
View all financial transfers in your account. You can use this to audit moving funds.

## Prompt Examples

**Prompt:** 
```
Show me my current Asaas balance.
```

**Response:** 
```
Your current balance in Asaas is **R$ 5,240.50**, with **R$ 1,200.00** pending settlement.
```

**Prompt:** 
```
List the last 5 payments received.
```

**Response:** 
```
I've pulled your recent payments. You received **5 payments** today, totaling **R$ 850.00**, including:

* 3 via PIX
* 2 via Credit Card
```

**Prompt:** 
```
Create a PIX charge of R$ 100 for customer 'cus_12345' due tomorrow.
```

**Response:** 
```
The PIX charge for **R$ 100.00** has been created for customer **cus_12345**. The due date is set for tomorrow.
```

## Capabilities

### Register new customers
Add client details and verify their tax IDs instantly to build your database.

### Generate payment links
Create PIX or Boleto charges for immediate collection during a sale.

### Track subscriptions
Monitor active recurring billings for your long-term clients in real time.

### Check account balances
Get a live look at your available funds and pending settlements.

### List all transactions
View every payment and financial transfer in your account for easier auditing.

### Sync customer data
Keep your contact list updated with the latest registration information automatically.

## Use Cases

### On-the-fly sales
A sales rep asks the agent to 'Create a PIX charge for R$ 200 for the new client.' The agent uses `create_payment` and gives the link immediately.

### Quick balance checks
A business owner asks 'What's my current balance?' The agent uses `get_balance` to show the total and pending settlement.

### Subscription audits
A manager asks for 'all active subscriptions.' The agent uses `list_subscriptions` to show a table of all recurring clients.

### Customer registration
A support agent tells the AI to 'Register a new customer with this CPF.' The agent uses `create_customer` to add them to the database.

## Benefits

- Faster Onboarding: Use `create_customer` to register clients and verify tax IDs instantly without manual form filling.
- Instant Payments: Generate PIX and Boleto charges with `create_payment` so you can collect money the moment a sale is made.
- Real-time Oversight: Check your current funds with `get_balance` to know exactly what's in your account at any second.
- Automated Tracking: Monitor all recurring billings using `list_subscriptions` to ensure no client ever misses a payment.
- Simplified Audits: Pull a full list of your charges using `list_payments` and `list_transfers` to keep your books organized.

## How It Works

The bottom line is you get a conversational interface for your entire Brazilian payment operations.

1. Provide your Asaas access token to your AI client through the Vinkius dashboard.
2. Give your agent a command to perform a billing task like creating a customer or checking a balance.
3. The agent executes the request via the Connector and shows you the result in your chat.

## Frequently Asked Questions

**Can Asaas MCP handle PIX payments?**
Yes, it allows your AI agent to create PIX charges and track their status instantly.

**Does Asaas MCP support recurring subscriptions?**
It can list and monitor all your active recurring billings in one go.

**Can I register customers using the Asaas MCP?**
You can have your agent register new customers and verify their details automatically.

**How do I check my balance with Asaas MCP?**
Just ask your AI client for your balance, and it will pull the live data from your account.

**Is Asaas MCP good for Brazilian businesses?**
It is specifically designed for the Brazilian market, supporting local payment methods and tax IDs.

**Can I see all my payments at once?**
Yes, your agent can pull a full list of your charges and payments whenever you ask.

**How do I find my Asaas API Key?**
Log in to your Asaas account, go to **Settings > API Integrations**, and you can generate your `access_token` there.

**Does this server support PIX payments?**
Yes, you can create PIX charges by setting the `billingType` to `PIX` when using the `create_payment` tool.

**Can I test this in Sandbox mode?**
Yes, configure the `ASAAS_SANDBOX` environment variable to `true` to connect to the Asaas Sandbox environment (`api-sandbox.asaas.com`).

**Can I manage financial transfers?**
Yes! Use the `list_transfers` action to monitor all outbound money moves, including their settlement status and target accounts.