Conta Azul MCP

io.github.douglac/contaazul-mcp · v0.1.0

Has write/delete toolsTools changed (7 days)No registry update 90+ days

Measured by MCP Station

Last check	Reachable
Checked at	—
Check success 7 / 30 days	—
First-try success 30 days	—
Median response	—
Lookups 30 days	—
Authentication	No auth
MCP version	2025-06-18
Rank score	—
Declared risk	Has destructive tools (destructiveHint)
Capabilities declared	tools
Tool definitions	58 tools · with description 100% · input schema is an object 100% · read/destructive hints 100%

Description written by the publisher, not verified

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

claude mcp add --transport http contaazul-mcp https://api.mcp.ai/contaazul

{
  "mcpServers": {
    "contaazul-mcp": {
      "url": "https://api.mcp.ai/contaazul"
    }
  }
}

Tools as reported by the server

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 write/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 write/delete
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 write/delete
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 write/delete
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 write/delete
Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.
contaazul_delete_contract write/delete
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 write/delete
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

Tool changes

2026-10-23: contaazul_list_accounts, contaazul_get_company, contaazul_list_people, contaazul_get_person, contaazul_person_write_create, contaazul_person_write_update, contaazul_person_delete, contaazul_list_products, contaazul_product_write, contaazul_list_services, contaazul_service_write, contaazul_list_sales
2026-10-16: contaazul_list_accounts, contaazul_get_company, contaazul_list_people, contaazul_get_person, contaazul_person_write_create, contaazul_person_write_update, contaazul_person_delete, contaazul_list_products, contaazul_product_write, contaazul_list_services, contaazul_service_write, contaazul_list_sales

Repository · JSON · Text for agents · Registry updated 2026-05-29