LabscoMCP early access ↗
douglacMCP SERVER

Conta Azul MCP

Run a Conta Azul ERP in Portuguese from your assistant — customers, products, sales, contracts, payables and receivables, instalment settlement and NF-e, over a hosted endpoint.

by douglac ↗ERP & Vertical Business SystemsCommunity

LABSCO SUMMARY

It writes to a live ERP, and the destructive tools have no easy undo.

Most finance connectors read; this one creates customers, issues sales, records payables and settles instalments against a real bank account. The server marks its destructive tools as such — contaazul_sale_cancel, contaazul_delete_contract and contaazul_person_delete among them — and none of those can be walked back without manual rework. Review the proposed action before confirming, treat the bearer token as full access to the connected company, and remember that with more than one company connected every call needs the account argument or it will land on the wrong books.

What it is

A hosted MCP server covering the Conta Azul v2 API — the Brazilian ERP — with tools across companies, people, products and services, sales, contracts, financial accounts and issued NF-e. It is not read-only: tools are labelled read, write or admin, and the admin ones cancel sales and contracts and delete people.

What you get

  • The connected companies and the active one's registration data — CNPJ, legal name, tax regime — with an optional account argument on every tool when more than one company is connected — contaazul_list_accounts, contaazul_get_company
  • People — customers, suppliers, sales reps, carriers — listed with filters, read by id, created, updated and deleted — contaazul_list_people, contaazul_get_person, contaazul_person_write_create, contaazul_person_write_update, contaazul_person_delete
  • Products and services listed and created — contaazul_list_products, contaazul_product_write, contaazul_list_services, contaazul_service_write
  • Sales listed by date range, customer and status, opened in detail, created, updated and cancelled — contaazul_list_sales, contaazul_get_sale, contaazul_sale_write_create, contaazul_sale_write_update, contaazul_sale_cancel
  • Contracts listed, read, created, ended and deleted — contaazul_list_contracts, contaazul_get_contract, contaazul_contract_write, contaazul_terminate_contract, contaazul_delete_contract
  • Receivables and payables listed by due-date range and status, and created — contaazul_list_receivables, contaazul_receivable_create, contaazul_list_payables, contaazul_payable_create
  • Instalments listed, read, updated and settled against a financial account with amount and payment date, and the settlements behind them listed, corrected or deleted — contaazul_list_installments, contaazul_get_installment, contaazul_update_installment, contaazul_settle_installment, contaazul_list_settlements, contaazul_update_settlement, contaazul_delete_settlement
  • The reference data those calls need: bank, cash and card accounts, income and expense categories, and cost centres — contaazul_list_financial_accounts, contaazul_list_categories, contaazul_list_cost_centers
  • Issued NF-e listed by issue date and status, and read individually — contaazul_list_invoices_nfe, contaazul_get_invoice_nfe

Requirements

A Conta Azul account, authorized over Conta Azul's own OAuth 2.0 — you never type a token. There is nothing to install: point any HTTP-capable MCP client at https://api.mcp.ai/contaazul and the config carries only that URL, with no headers. Modern clients run the OAuth flow in the browser; clients without OAuth get an authenticate tool instead, where you paste a JWT generated at https://app.mcp.ai/agent-auth — that JWT travels through your LLM provider's logs, so prefer the browser flow where the client supports it. It is a paid service: the free tier is 10 requests in a 24-hour window with no card, and the paid tiers differ by how many Conta Azul companies you may connect — one, up to 3, or 5 with extra companies at R$ 9 each — with unlimited requests on all of them. Sessions and company authorization are revoked from app.mcp.ai.

Setup effort

Add the hosted endpoint — paste it into your client

See installation options