mcpserver.lol
registry/contaazul-mcp
Connection check verified live · 27h ago

contaazul-mcp

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

Tools 57
GitHub stars
Installs / wk
Licence
Transport streamable-http
Last checked 27h ago

Tools & capabilities

57 tools

Read from the running server on 27h ago.

authenticate token
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…
connect read-only
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 tool…
contaazul_cancel_charge can modify data id*idsaccount
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_generat…
contaazul_contract_next_number read-only account
Retorna o próximo número de contrato disponível.
contaazul_contract_write data*account
Cria um contrato. `data` é o payload em JSON.
contaazul_create_budget data*account
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 pro…
contaazul_delete_budgets can modify data ids*account
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).
contaazul_delete_contract can modify data id*idsaccount
Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.
contaazul_delete_settlement can modify data id*idsaccount
Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
contaazul_generate_charge datatipo*forcaraccountid_parcelaids_parcelas +5
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…
contaazul_get_account_balance read-only id*idsaccount
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_get_budget read-only id*idsaccount
Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.
contaazul_get_charge read-only id*idsaccount
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, CANCEL…
contaazul_get_company read-only account
Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
contaazul_get_contract read-only id*idsaccount
Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.
contaazul_get_initial_balance read-only accountdata_fimdata_inicio
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_get_installment read-only id*idsaccount
Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.
contaazul_get_invoice_nfe read-only id*idsaccount
Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
contaazul_get_person read-only id*idsaccount
Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
contaazul_get_sale read-only id*idsaccount
Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
contaazul_get_settlement read-only id*idsaccount
Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
contaazul_list_accounts read-only account
Lista as empresas Conta Azul vinculadas a este install (company_id, label).
contaazul_list_budgets read-only paginaaccounttamanho_pagina
Lista orçamentos (cliente, número, total, situação, versão). Paginado.
contaazul_list_categories read-only tipopaginaaccounttamanho_pagina
Lista categorias financeiras (DRE).
contaazul_list_changed_events read-only paginaaccountdata_fimdata_iniciotamanho_pagina
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;…
contaazul_list_contracts read-only paginaaccountdata_fimcliente_idcliente_idsdata_inicio +2
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_pagi…
contaazul_list_cost_centers read-only paginaaccounttamanho_pagina
Lista centros de custo.
contaazul_list_financial_accounts read-only nometipospaginaaccountapenas_ativotamanho_pagina
Lista contas financeiras (banco, caixa, cartão). Filtre por `tipos`: APLICACAO, CAIXINHA, CONTA_CORRENTE, CARTAO_CREDITO, INVESTIMENTO, OUTROS, MEIOS_RECEBIMENTO, POUPANCA, COBRANC…
contaazul_list_installments read-only accountid_evento*
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_receiva…
contaazul_list_invoices_nfe read-only paginastatusaccounttamanho_paginadata_emissao_fimdata_emissao_inicio
Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.
contaazul_list_invoices_nfse read-only paginastatusaccountid_clientenumero_vendatamanho_pagina +7
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)…
contaazul_list_payables read-only paginastatusaccounttamanho_paginadata_vencimento_dedata_vencimento_ate
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, RECEBI…
contaazul_list_people read-only ativobuscapaginaaccounttipo_perfiltamanho_pagina
Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.
contaazul_list_products read-only ativobuscapaginaaccounttamanho_pagina
Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.
contaazul_list_receivables read-only paginastatusaccountids_clientestamanho_paginadata_vencimento_de +1
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, RECE…
contaazul_list_sales read-only paginaaccountdata_fimcliente_idcliente_idsdata_inicio +2
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.
contaazul_list_services read-only buscapaginaaccounttamanho_pagina
Lista serviços cadastrados.
contaazul_list_settlements read-only id*idsaccount
Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.
contaazul_list_transfers read-only paginaaccountdata_fimdata_iniciotamanho_pagina
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). Pagi…
contaazul_payable_create data*account
Cria um evento financeiro de conta a pagar. `data` é o JSON do EventoFinanceiroRequest (mesma estrutura do contaazul_receivable_create: data_competencia, valor, observacao, descric…
contaazul_person_delete can modify data id*idsaccount
Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
contaazul_person_write_create ididsdata*account
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 `dat…
contaazul_person_write_update ididsdata*account
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 `dat…
contaazul_product_write data*account
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_produc…
contaazul_receivable_create data*account
Cria um evento financeiro de conta a receber. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS: data_competencia (YYYY-MM-DD), valor (number), observacao, descricao, contat…
contaazul_sale_cancel can modify data id*idsaccount
Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
contaazul_sale_write_create ididsdata*account
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: accep…
contaazul_sale_write_update ididsdata*account
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: accep…
contaazul_service_write data*account
Cria um serviço. `data` é JSON com nome, valor, etc.
contaazul_settle_installment id*idsdata*account
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: da…
contaazul_terminate_contract can modify data id*idsaccount
Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.
contaazul_update_installment id*idsdata*account
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_liq…
contaazul_update_settlement id*idsdata*account
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…
marketplace limitqueryactionmcp_idmessagetool_id +17
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",…
report_bug contextmessage*conversation
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
show_version read-only
Show the current MCP platform and adapter versions.
toolkit_info read-only
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.