# Conta Azul MCP

- Registry name: `io.github.douglac/contaazul-mcp` · version 0.1.0
- Categories (automatic, keyword rules): Utilities
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.douglac%2Fcontaazul-mcp
- Server page: https://mcpstation.net/s/io.github.douglac--contaazul-mcp.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://api.mcp.ai/contaazul`

## Tools (as reported by the server, not verified)

- `contaazul\_list\_accounts`: Lista as empresas Conta Azul vinculadas a este install \(company\_id, label\).
- `contaazul\_get\_company`: Dados da empresa Conta Azul ativa \(CNPJ, razão social, regime tributário\).
- `contaazul\_list\_people`: Lista pessoas \(clientes, fornecedores, vendedores, transportadores\) cadastradas. Filtros via params: tamanho\_pagina, pagina, busca \(nome/documento\), tipo\_perfil, ativo.
- `contaazul\_get\_person`: Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
- `contaazul\_person\_write\_create`: Cria ou atualiza uma pessoa. action=create: requer nome, tipo\_pessoa e \(cpf\|cnpj\) — passe os campos via \`data\` \(JSON\). action=update: requer id e APENAS os campos a alterar em \`data\` \(JSON\) — é update PARCIAL: o resto do cadastro fica intacto e campo que o registro não tem NÃO é exigido \(dá pra troc
- `contaazul\_person\_write\_update`: Cria ou atualiza uma pessoa. action=create: requer nome, tipo\_pessoa e \(cpf\|cnpj\) — passe os campos via \`data\` \(JSON\). action=update: requer id e APENAS os campos a alterar em \`data\` \(JSON\) — é update PARCIAL: o resto do cadastro fica intacto e campo que o registro não tem NÃO é exigido \(dá pra troc
- `contaazul\_person\_delete`: Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
- `contaazul\_list\_products`: Lista produtos cadastrados. Filtros: tamanho\_pagina, pagina, busca, ativo.
- `contaazul\_product\_write`: Cria um produto \(nome + valor\_venda obrigatórios em \`data\` JSON\). A API v2 do Conta Azul não expõe atualização nem GET de produto por id — para consultar, use contaazul\_list\_products \(/produto/busca\) com filtro.
- `contaazul\_list\_services`: Lista serviços cadastrados.
- `contaazul\_service\_write`: Cria um serviço. \`data\` é JSON com nome, valor, etc.
- `contaazul\_list\_sales`: Lista vendas \(GET /venda/busca\). Filtros: data\_inicio/data\_fim \(emissão, AAAA-MM-DD\), data\_criacao\_de/ate \(AAAA-MM-DD\), data\_alteracao\_de/ate \(AAAA-MM-DDTHH:MM:SS\), ids\_clientes, ids\_vendedores, ids\_categorias, ids\_produtos, numeros, situacoes \(enum de BUSCA: in\_process, approved, invoiced, canceled
- `contaazul\_list\_sale\_items`: Itens \(produtos/serviços, quantidade, valor\) de uma ou mais vendas. Passe ids\_venda \(até 50\); devolve um resultado por venda.
- `contaazul\_get\_sale`: Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
- `contaazul\_sale\_write\_create`: Cria ou atualiza venda. \`data\` é o payload da venda em JSON. action=create \(POST /venda\) — OBRIGATÓRIOS: id\_cliente \(UUID, via contaazul\_list\_people\), situacao \(EM\_ANDAMENTO ou APROVADO\), data\_venda \(AAAA-MM-DD\), itens\[\] e condicao\_pagamento; \`numero\` é obrigatório na API mas, se omitido, usamos o p
- `contaazul\_sale\_write\_update`: Cria ou atualiza venda. \`data\` é o payload da venda em JSON. action=create \(POST /venda\) — OBRIGATÓRIOS: id\_cliente \(UUID, via contaazul\_list\_people\), situacao \(EM\_ANDAMENTO ou APROVADO\), data\_venda \(AAAA-MM-DD\), itens\[\] e condicao\_pagamento; \`numero\` é obrigatório na API mas, se omitido, usamos o p
- `contaazul\_sale\_cancel`: Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
- `contaazul\_list\_contracts`: Lista contratos no intervalo de data de início \(data\_inicio/data\_fim, YYYY-MM-DD — obrigatórios na API; se omitidos, usa janela ampla = listar todos\). Filtros: pagina, tamanho\_pagina \(máx 50\), cliente\_id, busca\_textual. A API v2 não tem GET contrato por id nem cancelar/excluir. Bulk support: accepts
- `contaazul\_contract\_write`: Cria um contrato. \`data\` é o payload em JSON.
- `contaazul\_list\_receivables`: Lista contas a receber \(parcelas de receita\). Filtros: tamanho\_pagina, pagina, data\_vencimento\_de, data\_vencimento\_ate \(YYYY-MM-DD; se omitidas, lista todas\), status \(PERDIDO, RECEBIDO, EM\_ABERTO, RENEGOCIADO, RECEBIDO\_PARCIAL, ATRASADO\), ids\_clientes \(UUID do cliente\).
- `contaazul\_receivable\_create`: Cria um evento financeiro de conta a receber. \`data\` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS \(a chamada é recusada antes de ir à API se faltar algum\): id\_cliente \(UUID do cliente, via contaazul\_list\_people; \`contato\` é aceito como alias\), conta\_financeira \(UUID, via contaazul\_list\_financia
- `contaazul\_list\_payables`: Lista contas a pagar \(parcelas de despesa\). Filtros: tamanho\_pagina, pagina, data\_vencimento\_de, data\_vencimento\_ate \(YYYY-MM-DD; se omitidas, lista todas\), status \(PERDIDO, RECEBIDO, EM\_ABERTO, RENEGOCIADO, RECEBIDO\_PARCIAL, ATRASADO\). O Conta Azul usa os MESMOS status de contas a receber \(RECEBIDO
- `contaazul\_payable\_create`: Cria um evento financeiro de conta a pagar. \`data\` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS \(a chamada é recusada antes de ir à API se faltar algum\): id\_fornecedor \(UUID do fornecedor, via contaazul\_list\_people; \`contato\` é aceito como alias\), conta\_financeira \(UUID, via contaazul\_list\_fina
- `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.
- `contaazul\_get\_installment`: Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.
- `contaazul\_update\_installment`: Atualiza campos de uma parcela \(PATCH\). Campos editáveis em \`data\` JSON: nota, descricao, vencimento \(YYYY-MM-DD\), composicao\_valor:\{valor\_bruto,multa,juros,desconto,taxa,valor\_liquido\}, data\_pagamento\_esperado, metodo\_pagamento, perda, nsu, pagamento\_agendado, id\_conta\_financeira. O campo \`versao\`
- `contaazul\_list\_financial\_accounts`: Lista contas financeiras \(banco, caixa, cartão\). Filtre por \`tipos\`: APLICACAO, CAIXINHA, CONTA\_CORRENTE, CARTAO\_CREDITO, INVESTIMENTO, OUTROS, MEIOS\_RECEBIMENTO, POUPANCA, COBRANCAS\_CONTA\_AZUL, RECEBA\_FACIL\_CARTAO. Para achar a conta que recebe cobranças \(contaazul\_generate\_charge\) use tipos=\["COBR
- `contaazul\_get\_account\_balance`: Saldo atual de uma conta financeira por id \(banco/caixa/cartão\). Pegue o id em contaazul\_list\_financial\_accounts. Bulk support: accepts ids for batched execution.
- `contaazul\_list\_categories`: Lista categorias financeiras \(DRE\).
- `contaazul\_list\_cost\_centers`: Lista centros de custo.
- `contaazul\_list\_invoices\_nfe`: Lista NF-e \(notas fiscais de produto\) EMITIDAS ou CORRIGIDAS COM SUCESSO \(a API não filtra por status\). data\_inicial e data\_final \(AAAA-MM-DD\) são OBRIGATÓRIAS na API e a janela máxima dela é de 15 dias: se omitidas, usamos os últimos 15 dias; se vier só uma, a outra fica a 15 dias de distância; jan
- `contaazul\_get\_invoice\_nfe`: Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
- `contaazul\_list\_invoices\_nfse`: Lista NFS-e \(notas fiscais de serviço\) por filtro. Exige data\_competencia\_de e data\_competencia\_ate \(YYYY-MM-DD\), com janela máxima de 15 dias \(se omitidas, usa os últimos 15 dias; se vier só uma, a outra fica a 15 dias de distância\). Outros filtros: id\_cliente, numero\_venda, status \(PENDENTE, PRONT
- `contaazul\_settle\_installment`: Registra a baixa \(recebimento/pagamento\) de uma parcela. \`id\` é o UUID da PARCELA \(via contaazul\_list\_receivables / \_list\_payables / \_get\_installment\). \`data\` é o JSON da baixa: data\_pagamento \(YYYY-MM-DD\), composicao\_valor \{valor\_bruto, multa, juros, desconto, taxa, valor\_liquido\}, conta\_financeira
- `contaazul\_list\_settlements`: Lista as baixas de uma parcela. \`id\` é o UUID da parcela. Bulk support: accepts ids for batched execution.
- `contaazul\_get\_settlement`: Detalhe de uma baixa por id. \`id\` é o UUID da baixa. Bulk support: accepts ids for batched execution.
- `contaazul\_update\_settlement`: Atualiza uma baixa \(PATCH\). \`id\` é o UUID da baixa. \`data\` é o JSON com os campos a alterar \(data\_pagamento, composicao\_valor, conta\_financeira em UUID string, metodo\_pagamento com o mesmo enum de contaazul\_settle\_installment, observacao\). O campo \`versao\` é buscado automaticamente. Bulk support: ac
- `contaazul\_delete\_settlement`: Estorna \(remove\) uma baixa por id. Operação destrutiva, confirme antes. \`id\` é o UUID da baixa. Bulk support: accepts ids for batched execution.
- `contaazul\_list\_transfers`: Lista transferências entre contas financeiras por período \(conciliação\). data\_inicio e data\_fim \(YYYY-MM-DD\) com janela máxima de 1 ano \(se omitidas, usa os últimos 365 dias\). Paginado.
- `contaazul\_get\_initial\_balance`: Saldos iniciais das contas financeiras por período. data\_inicio e data\_fim \(YYYY-MM-DD ou ISO date-time; datas simples são normalizadas\). Se omitidas, usa uma janela ampla.
- `contaazul\_list\_changed\_events`: Lista os IDs de eventos financeiros alterados num período \(para sync incremental / conciliação\). data\_inicio e data\_fim \(YYYY-MM-DD ou ISO date-time\). Paginado. Retorna só os IDs; use contaazul\_get\_installment para o detalhe.
- `contaazul\_generate\_charge`: Gera cobrança \(boleto, pix ou link de pagamento\) para uma ou mais PARCELAS de contas a receber. Aceita até 50 parcelas por chamada; cada uma é emitida separadamente e uma falha não aborta o lote. \`tipo\` \(obrigatório\) aceita EXATAMENTE: BOLETO, PIX\_COBRANCA ou LINK\_PAGAMENTO \(cartão de crédito sai po
- `contaazul\_get\_charge`: Detalhe de uma cobrança emitida por id \(o \`id\` devolvido em contaazul\_generate\_charge\). Retorna \{id, url, status\} — status vai de AGUARDANDO\_CONFIRMACAO/REGISTRADO até PAGO, CANCELADO, EXPIRADO ou FALHA\_EMISSAO. Bulk support: accepts ids for batched execution.
- `contaazul\_cancel\_charge`: CANCELA uma cobrança já emitida \(boleto/pix/link deixa de ser pagável\). Use quando a cobrança foi gerada errada e ainda não foi paga. Passe o \`id\` da cobrança \(de contaazul\_generate\_charge ou contaazul\_get\_charge\), NÃO o id da parcela. Bulk support: accepts ids for batched execution.
- `contaazul\_get\_contract`: Detalhe de um contrato por id \(cliente, termos, condição de pagamento, composição de valor\). Bulk support: accepts ids for batched execution.
- `contaazul\_contract\_next\_number`: Retorna o próximo número de contrato disponível.
- `contaazul\_terminate\_contract`: Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.
- `contaazul\_delete\_contract`: Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.
- `contaazul\_list\_budgets`: Lista orçamentos \(cliente, número, total, situação, versão\). Paginado.
- `contaazul\_get\_budget`: Detalhe de um orçamento por id \(itens, cliente, composição de valor\). Bulk support: accepts ids for batched execution.
- `contaazul\_create\_budget`: Cria um orçamento. \`data\` é o JSON com id\_cliente \(obrigatório, UUID de uma pessoa com perfil Cliente\), data\_orcamento \(obrigatório, YYYY-MM-DD\), itens\[\] \(cada item exige id do produto/serviço + tipo/quantidade/valor\), data\_validade, id\_vendedor e composicao\_de\_valor \(frete, desconto\).
- `contaazul\_delete\_budgets`: Exclui orçamentos em lote por id. Operação destrutiva, confirme antes. \`ids\` é a lista de UUIDs de orçamento \(a API v2 não tem exclusão por id única\).
- `show\_version`: Show the current MCP platform and adapter versions.
- `report\_bug`: Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
- `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.
- `toolkit\_info`: Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
- `marketplace`: The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile \(ev
- `authenticate`: MCP.AI for IDE agents \(Cursor, etc.\): log in in the browser, copy the access token. Best: add it to this server's config as a header \`Authorization: Bearer \<token\>\` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with \{ token: "\<jwt\>" \} after the user pastes

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html