# Conta Azul MCP MCP server

Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-douglac-contaazul-mcp
- Repository: https://github.com/douglac/contaazul-mcp

## Install
- Endpoint: https://api.mcp.ai/contaazul
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.mcp.ai/contaazul

## Tools
- contaazul_list_accounts - Lista as empresas Conta Azul vinculadas a este install (company_id, label). Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_company - Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário). Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_people - Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo, ativo. Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_person - Detalhe de uma pessoa por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_person_write_create - Cria ou atualiza uma pessoa. action=create: requer nome e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e os campos a alterar em `data` (JSON).

[Flattened action: create]

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_person_write_update - Cria ou atualiza uma pessoa. action=create: requer nome e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e os campos a alterar em `data` (JSON).

[Flattened action: update]

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_person_delete - Remove uma pessoa por id. Operação destrutiva — confirme antes.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_products - Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo. Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_product - Detalhe de produto por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_product_write_create - Cria ou atualiza produto. action=create: nome + valor_venda obrigatórios em `data`. action=update: id obrigatório.

[Flattened action: create]

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_product_write_update - Cria ou atualiza produto. action=create: nome + valor_venda obrigatórios em `data`. action=update: id obrigatório.

[Flattened action: update]

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_services - Lista serviços cadastrados. Endpoint: https://api.mcp.ai/contaazul
- contaazul_service_write - Cria um serviço. `data` é JSON com nome, valor, etc. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_sales - Lista vendas. Filtros: tamanho_pagina, pagina, data_inicio, data_fim (YYYY-MM-DD), cliente_id, status_venda.

Bulk support: accepts cliente_ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_sale - Detalhe de uma venda por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_sale_write_create - Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON.

[Flattened action: create]

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_sale_write_update - Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON.

[Flattened action: update]

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_sale_cancel - Cancela uma venda. Operação destrutiva — confirme antes.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_contracts - Lista contratos. Filtros: tamanho_pagina, pagina, cliente_id, status.

Bulk support: accepts cliente_ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_contract - Detalhe de contrato por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_contract_write - Cria um contrato. `data` é o payload em JSON. Endpoint: https://api.mcp.ai/contaazul
- contaazul_contract_cancel - Cancela/remove um contrato.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_receivables - Lista contas a receber. Filtros: tamanho_pagina, pagina, data_inicio, data_fim, status (PENDENTE, PAGO, ATRASADO), cliente_id.

Bulk support: accepts cliente_ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_receivable_create - Cria uma conta a receber. `data` em JSON. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_payables - Lista contas a pagar. Filtros: tamanho_pagina, pagina, data_inicio, data_fim, status, fornecedor_id.

Bulk support: accepts fornecedor_ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_payable_create - Cria uma conta a pagar. `data` em JSON. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_installments - Lista as parcelas de UM evento financeiro (passe `id_evento`). A API v2 não tem listagem chapada de todas as parcelas — pra varrer contas a receber/pagar use contaazul_list_receivables / contaazul_list_payables. Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_installment - Detalhe de uma parcela por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_settle_installment - Quita (settle) uma parcela. `data` em JSON com parcela_id, conta_financeira_id, valor_pago, data_pagamento. Endpoint: https://api.mcp.ai/contaazul
- contaazul_unsettle_installment - Desfaz uma quitação por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_financial_accounts - Lista contas financeiras (banco, caixa, cartão). Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_categories - Lista categorias financeiras (DRE). Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_cost_centers - Lista centros de custo. Endpoint: https://api.mcp.ai/contaazul
- contaazul_list_invoices_nfe - Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status. Endpoint: https://api.mcp.ai/contaazul
- contaazul_get_invoice_nfe - Detalhe de uma NF-e por id.

Bulk support: accepts ids for batched execution. Endpoint: https://api.mcp.ai/contaazul
- show_version - Show the current MCP platform and adapter versions. Endpoint: https://api.mcp.ai/contaazul
- report_bug - Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Endpoint: https://api.mcp.ai/contaazul
- connect - Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs. Endpoint: https://api.mcp.ai/contaazul
- toolkit_info - Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes. Endpoint: https://api.mcp.ai/contaazul
- marketplace - [BETA] Global MCP marketplace. action=search finds MCPs outside this toolkit. action=install adds a new MCP. action=uninstall removes one. Currently returns a mock for debug. Endpoint: https://api.mcp.ai/contaazul
- authenticate - MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token, paste here. Call with { token: "<jwt>" } after the user pastes, or with no args to get the link. Endpoint: https://api.mcp.ai/contaazul

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.douglac
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 29, 2026
- Source: https://registry.modelcontextprotocol.io