Asaas — REST API skill

Você tem acesso à Asaas REST API na MCP.AI.

Conta digital e cobranças no Asaas com a API REST oficial v3 completa (api.asaas.com), saldo, cobranças (boleto/PIX/cartão), assinaturas, parcelamentos, links de pagamento, split, antecipações, transferências, PIX, extrato, notas fiscais e subcontas. Consulta e operação. Pareia com o Banco MCP, o Banco mostra o que entrou na conta, o Asaas opera o que você cobra. Autenticação por chave de API (gerada na conta Asaas, em Configurações, Integrações, Chave de API).

Base URL

https://api.mcp.ai/api/asaas

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/asaas/accounts/access/tokens/create \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"id":"..."}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/asaas/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (211)

#### asaas_accounts_access_tokens_create

Create API key for a subaccount (POST /v3/accounts/{id}/accessTokens). [write, mexe em dinheiro] _(POST /api/asaas/accounts/access/tokens/create)_

#### asaas_accounts_access_tokens_delete

Delete API key for a subaccount (DELETE /v3/accounts/{id}/accessTokens/{accessTokenId}). [write, mexe em dinheiro] _(POST /api/asaas/accounts/access/tokens/delete)_

#### asaas_accounts_access_tokens_list

List API keys for a subaccount (GET /v3/accounts/{id}/accessTokens). _(POST /api/asaas/accounts/access/tokens/list)_

#### asaas_accounts_access_tokens_update

Update API key for a subaccount (PUT /v3/accounts/{id}/accessTokens/{accessTokenId}). [write, mexe em dinheiro] _(POST /api/asaas/accounts/access/tokens/update)_

#### asaas_accounts_create

Create subaccount (POST /v3/accounts). [write, mexe em dinheiro] _(POST /api/asaas/accounts/create)_

#### asaas_accounts_delete

Close non-BaaS subaccount (DELETE /v3/accounts/{id}). [write, mexe em dinheiro] _(POST /api/asaas/accounts/delete)_

#### asaas_accounts_escrow_create

Save or update Escrow Account configuration for subaccount (POST /v3/accounts/{id}/escrow). [write, mexe em dinheiro] _(POST /api/asaas/accounts/escrow/create)_

#### asaas_accounts_escrow_create_2

Create default Escrow Account configuration to all subaccounts (POST /v3/accounts/escrow). [write, mexe em dinheiro] _(POST /api/asaas/accounts/escrow/create/2)_

#### asaas_accounts_escrow_list

Reterive Escrow Account configuration for subaccount (GET /v3/accounts/{id}/escrow). _(POST /api/asaas/accounts/escrow/list)_

#### asaas_accounts_escrow_list_2

Retrieve default Escrow Account configuration (GET /v3/accounts/escrow). _(POST /api/asaas/accounts/escrow/list/2)_

#### asaas_accounts_get

Retrieve a single subaccount (GET /v3/accounts/{id}). _(POST /api/asaas/accounts/get)_

#### asaas_accounts_list

List subaccounts (GET /v3/accounts). _(POST /api/asaas/accounts/list)_

#### asaas_accounts_resend_activation_link_create

Resend activation link for non-BaaS subaccount (POST /v3/accounts/{id}/resendActivationLink). [write, mexe em dinheiro] _(POST /api/asaas/accounts/resend/activation/link/create)_

#### asaas_anticipations_cancel_create

Cancel anticipation (POST /v3/anticipations/{id}/cancel). [write, mexe em dinheiro] _(POST /api/asaas/anticipations/cancel/create)_

#### asaas_anticipations_configurations_list

Retrieve status of automatic anticipation (GET /v3/anticipations/configurations). _(POST /api/asaas/anticipations/configurations/list)_

#### asaas_anticipations_configurations_update

Update status of automatic anticipation (PUT /v3/anticipations/configurations). [write, mexe em dinheiro] _(POST /api/asaas/anticipations/configurations/update)_

#### asaas_anticipations_create

Request anticipation (POST /v3/anticipations). [write, mexe em dinheiro] _(POST /api/asaas/anticipations/create)_

#### asaas_anticipations_get

Retrieve a single anticipation (GET /v3/anticipations/{id}). _(POST /api/asaas/anticipations/get)_

#### asaas_anticipations_limits_list

Retrieve anticipation limits (GET /v3/anticipations/limits). _(POST /api/asaas/anticipations/limits/list)_

#### asaas_anticipations_list

List anticipations (GET /v3/anticipations). _(POST /api/asaas/anticipations/list)_

#### asaas_anticipations_simulate_create

Simulate anticipation (POST /v3/anticipations/simulate). [write, mexe em dinheiro] _(POST /api/asaas/anticipations/simulate/create)_

#### asaas_bill_cancel_create

Cancel bill payments (POST /v3/bill/{id}/cancel). [write, mexe em dinheiro] _(POST /api/asaas/bill/cancel/create)_

#### asaas_bill_create

Create a bill payment (POST /v3/bill). [write, mexe em dinheiro] _(POST /api/asaas/bill/create)_

#### asaas_bill_get

Retrieve a single bill payment (GET /v3/bill/{id}). _(POST /api/asaas/bill/get)_

#### asaas_bill_list

List bill payments (GET /v3/bill). _(POST /api/asaas/bill/list)_

#### asaas_bill_simulate_create

Simulate a bill payment (POST /v3/bill/simulate). [write, mexe em dinheiro] _(POST /api/asaas/bill/simulate/create)_

#### asaas_chargebacks_dispute_create

Create a chargeback dispute (POST /v3/chargebacks/{id}/dispute). [write, mexe em dinheiro] _(POST /api/asaas/chargebacks/dispute/create)_

#### asaas_chargebacks_list

List chargebacks (GET /v3/chargebacks/). _(POST /api/asaas/chargebacks/list)_

#### asaas_checkouts_cancel_create

Cancel a checkout (POST /v3/checkouts/{id}/cancel). [write, mexe em dinheiro] _(POST /api/asaas/checkouts/cancel/create)_

#### asaas_checkouts_create

Create new checkout (POST /v3/checkouts). [write, mexe em dinheiro] _(POST /api/asaas/checkouts/create)_

#### asaas_credit_bureau_report_create

Make consultation (POST /v3/creditBureauReport). [write, mexe em dinheiro] _(POST /api/asaas/credit/bureau/report/create)_

#### asaas_credit_bureau_report_get

Retrieve a credit bureau report (GET /v3/creditBureauReport/{id}). _(POST /api/asaas/credit/bureau/report/get)_

#### asaas_credit_bureau_report_list

List credit bureau reports (GET /v3/creditBureauReport). _(POST /api/asaas/credit/bureau/report/list)_

#### asaas_credit_card_pre_authorization_config_create

Save or update pre-authorization configuration (POST /v3/creditCard/preAuthorization/config). [write, mexe em dinheiro] _(POST /api/asaas/credit/card/pre/authorization/config/create)_

#### asaas_credit_card_pre_authorization_config_list

Retrieve pre-authorization configuration (GET /v3/creditCard/preAuthorization/config). _(POST /api/asaas/credit/card/pre/authorization/config/list)_

#### asaas_credit_card_tokenize_credit_card_create

Credit card tokenization (POST /v3/creditCard/tokenizeCreditCard). [write, mexe em dinheiro] _(POST /api/asaas/credit/card/tokenize/credit/card/create)_

#### asaas_customers_create

Create new customer (POST /v3/customers). [write, mexe em dinheiro] _(POST /api/asaas/customers/create)_

#### asaas_customers_delete

Remove Customer (DELETE /v3/customers/{id}). [write, mexe em dinheiro] _(POST /api/asaas/customers/delete)_

#### asaas_customers_get

Retrieve a single customer (GET /v3/customers/{id}). _(POST /api/asaas/customers/get)_

#### asaas_customers_list

List customers (GET /v3/customers). _(POST /api/asaas/customers/list)_

#### asaas_customers_notifications_list

Retrieve notifications from a customer (GET /v3/customers/{id}/notifications). _(POST /api/asaas/customers/notifications/list)_

#### asaas_customers_restore_create

Restore removed customer (POST /v3/customers/{id}/restore). [write, mexe em dinheiro] _(POST /api/asaas/customers/restore/create)_

#### asaas_customers_update

Update existing customer (PUT /v3/customers/{id}). [write, mexe em dinheiro] _(POST /api/asaas/customers/update)_

#### asaas_escrow_finish_create

Finish payment escrow in the Escrow Account (POST /v3/escrow/{id}/finish). [write, mexe em dinheiro] _(POST /api/asaas/escrow/finish/create)_

#### asaas_finance_balance

Retrieve account balance (GET /v3/finance/balance). _(POST /api/asaas/finance/balance)_

#### asaas_finance_payment_statistics

Collections statistics (GET /v3/finance/payment/statistics). _(POST /api/asaas/finance/payment/statistics)_

#### asaas_finance_split_statistics

Retrieve split values (GET /v3/finance/split/statistics). _(POST /api/asaas/finance/split/statistics)_

#### asaas_financial_transactions_list

Retrieve extract (GET /v3/financialTransactions). _(POST /api/asaas/financial/transactions/list)_

#### asaas_fiscal_info_create

Create and update tax information (POST /v3/fiscalInfo/). [write, mexe em dinheiro] _(POST /api/asaas/fiscal/info/create)_

#### asaas_fiscal_info_federal_service_codes_list

List federal service codes (GET /v3/fiscalInfo/federalServiceCodes). _(POST /api/asaas/fiscal/info/federal/service/codes/list)_

#### asaas_fiscal_info_list

Retrieve tax information (GET /v3/fiscalInfo/). _(POST /api/asaas/fiscal/info/list)_

#### asaas_fiscal_info_municipal_options_list

List municipal configurations (GET /v3/fiscalInfo/municipalOptions). _(POST /api/asaas/fiscal/info/municipal/options/list)_

#### asaas_fiscal_info_national_portal_create

Configure invoice issuing portal (POST /v3/fiscalInfo/nationalPortal). [write, mexe em dinheiro] _(POST /api/asaas/fiscal/info/national/portal/create)_

#### asaas_fiscal_info_nbs_codes_list

List NBS codes (GET /v3/fiscalInfo/nbsCodes). _(POST /api/asaas/fiscal/info/nbs/codes/list)_

#### asaas_fiscal_info_operation_indicator_codes_list

List operation indicator codes (GET /v3/fiscalInfo/operationIndicatorCodes). _(POST /api/asaas/fiscal/info/operation/indicator/codes/list)_

#### asaas_fiscal_info_services_list

List municipal services (GET /v3/fiscalInfo/services). _(POST /api/asaas/fiscal/info/services/list)_

#### asaas_fiscal_info_tax_classification_codes_list

List tax classification codes (GET /v3/fiscalInfo/taxClassificationCodes). _(POST /api/asaas/fiscal/info/tax/classification/codes/list)_

#### asaas_fiscal_info_tax_situation_codes_list

List tax situation codes (GET /v3/fiscalInfo/taxSituationCodes). _(POST /api/asaas/fiscal/info/tax/situation/codes/list)_

#### asaas_installments_create

Create Installment (POST /v3/installments). [write, mexe em dinheiro] _(POST /api/asaas/installments/create)_

#### asaas_installments_create_credit_card

Create Installment with credit card (POST /v3/installments/). [write, mexe em dinheiro] _(POST /api/asaas/installments/create/credit/card)_

#### asaas_installments_delete

Remove installment (DELETE /v3/installments/{id}). [write, mexe em dinheiro] _(POST /api/asaas/installments/delete)_

#### asaas_installments_get

Retrieve a single installment (GET /v3/installments/{id}). _(POST /api/asaas/installments/get)_

#### asaas_installments_list

List installments (GET /v3/installments). _(POST /api/asaas/installments/list)_

#### asaas_installments_payment_book_list

Generate installment booklet (GET /v3/installments/{id}/paymentBook). _(POST /api/asaas/installments/payment/book/list)_

#### asaas_installments_payments_delete

Cancel charges of an installment (pending and overdue) (DELETE /v3/installments/{id}/payments). [write, mexe em dinheiro] _(POST /api/asaas/installments/payments/delete)_

#### asaas_installments_payments_list

List payments of a installment (GET /v3/installments/{id}/payments). _(POST /api/asaas/installments/payments/list)_

#### asaas_installments_refund_create

Refund installment (POST /v3/installments/{id}/refund). [write, mexe em dinheiro] _(POST /api/asaas/installments/refund/create)_

#### asaas_installments_splits_update

Update installment splits (PUT /v3/installments/{id}/splits). [write, mexe em dinheiro] _(POST /api/asaas/installments/splits/update)_

#### asaas_invoices_authorize_create

Issue an invoice (POST /v3/invoices/{id}/authorize). [write, mexe em dinheiro] _(POST /api/asaas/invoices/authorize/create)_

#### asaas_invoices_cancel_create

Cancel an invoice (POST /v3/invoices/{id}/cancel). [write, mexe em dinheiro] _(POST /api/asaas/invoices/cancel/create)_

#### asaas_invoices_create

Schedule invoice (POST /v3/invoices). [write, mexe em dinheiro] _(POST /api/asaas/invoices/create)_

#### asaas_invoices_get

Retrieve a single invoice (GET /v3/invoices/{id}). _(POST /api/asaas/invoices/get)_

#### asaas_invoices_list

List invoices (GET /v3/invoices). _(POST /api/asaas/invoices/list)_

#### asaas_invoices_update

Update invoice (PUT /v3/invoices/{id}). [write, mexe em dinheiro] _(POST /api/asaas/invoices/update)_

#### asaas_lean_payments_capture_authorized_payment_create

Capture payment with Pre-Authorization with summary data in response (POST /v3/lean/payments/{id}/captureAuthorizedPayment). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/capture/authorized/payment/create)_

#### asaas_lean_payments_create_credit_card

Create new payment with credit card with summary data in response (POST /v3/lean/payments/). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/create/credit/card)_

#### asaas_lean_payments_create_lean

Create new payment with summary data in response (POST /v3/lean/payments). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/create/lean)_

#### asaas_lean_payments_delete

Delete payment with summary data (DELETE /v3/lean/payments/{id}). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/delete)_

#### asaas_lean_payments_get

Retrieve a single payment with summary data (GET /v3/lean/payments/{id}). _(POST /api/asaas/lean/payments/get)_

#### asaas_lean_payments_list

List payments with summary data (GET /v3/lean/payments). _(POST /api/asaas/lean/payments/list)_

#### asaas_lean_payments_receive_in_cash_create

Confirm cash receipt with summary data in response (POST /v3/lean/payments/{id}/receiveInCash). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/receive/in/cash/create)_

#### asaas_lean_payments_refund_create

Refund payment with summary data in response (POST /v3/lean/payments/{id}/refund). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/refund/create)_

#### asaas_lean_payments_restore_create

Restore removed payment with summary data in response (POST /v3/lean/payments/{id}/restore). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/restore/create)_

#### asaas_lean_payments_undo_received_in_cash_create

Undo cash receipt confirmation with summary data in response (POST /v3/lean/payments/{id}/undoReceivedInCash). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/undo/received/in/cash/create)_

#### asaas_lean_payments_update

Update existing payment with summary data in response (PUT /v3/lean/payments/{id}). [write, mexe em dinheiro] _(POST /api/asaas/lean/payments/update)_

#### asaas_list_accounts

Lista as conexões (contas) Asaas vinculadas a este install — id, label. _(POST /api/asaas/list/accounts)_

#### asaas_mobile_phone_recharges_cancel_create

Cancel a cell phone recharge (POST /v3/mobilePhoneRecharges/{id}/cancel). [write, mexe em dinheiro] _(POST /api/asaas/mobile/phone/recharges/cancel/create)_

#### asaas_mobile_phone_recharges_create

Request recharge (POST /v3/mobilePhoneRecharges). [write, mexe em dinheiro] _(POST /api/asaas/mobile/phone/recharges/create)_

#### asaas_mobile_phone_recharges_get

Recover a single cell phone recharge (GET /v3/mobilePhoneRecharges/{id}). _(POST /api/asaas/mobile/phone/recharges/get)_

#### asaas_mobile_phone_recharges_list

List cell phone top-ups (GET /v3/mobilePhoneRecharges). _(POST /api/asaas/mobile/phone/recharges/list)_

#### asaas_mobile_phone_recharges_provider_list

Search for cell phone provider (GET /v3/mobilePhoneRecharges/{phoneNumber}/provider). _(POST /api/asaas/mobile/phone/recharges/provider/list)_

#### asaas_my_account_account_number_list

Retrieve Asaas account number (GET /v3/myAccount/accountNumber). _(POST /api/asaas/my/account/account/number/list)_

#### asaas_my_account_commercial_info_create

Update business data (POST /v3/myAccount/commercialInfo/). [write, mexe em dinheiro] _(POST /api/asaas/my/account/commercial/info/create)_

#### asaas_my_account_commercial_info_list

Retrieve business data (GET /v3/myAccount/commercialInfo/). _(POST /api/asaas/my/account/commercial/info/list)_

#### asaas_my_account_delete

Delete White Label subaccount (DELETE /v3/myAccount/). [write, mexe em dinheiro] _(POST /api/asaas/my/account/delete)_

#### asaas_my_account_documents_create

Send documents (POST /v3/myAccount/documents/{id}). [write, mexe em dinheiro] _(POST /api/asaas/my/account/documents/create)_

#### asaas_my_account_documents_files_create

Update sent document (POST /v3/myAccount/documents/files/{id}). [write, mexe em dinheiro] _(POST /api/asaas/my/account/documents/files/create)_

#### asaas_my_account_documents_files_delete

Remove sent document (DELETE /v3/myAccount/documents/files/{id}). [write, mexe em dinheiro] _(POST /api/asaas/my/account/documents/files/delete)_

#### asaas_my_account_documents_files_get

View document sent (GET /v3/myAccount/documents/files/{id}). _(POST /api/asaas/my/account/documents/files/get)_

#### asaas_my_account_documents_list

Check pending documents (GET /v3/myAccount/documents). _(POST /api/asaas/my/account/documents/list)_

#### asaas_my_account_fees_list

Retrieve account fees (GET /v3/myAccount/fees/). _(POST /api/asaas/my/account/fees/list)_

#### asaas_my_account_payment_checkout_config_create

Save payment checkout customization (POST /v3/myAccount/paymentCheckoutConfig/). [write, mexe em dinheiro] _(POST /api/asaas/my/account/payment/checkout/config/create)_