mcp server

Conta Azul MCP

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

Description as published by the maintainer. Source

• version 0.1.0
• active

active — Most recent push to the repository was 2026-06-23.

What this server can do

57 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

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, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

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.

contaazul_cancel_charge(id, ids, account)

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. Required: id.

contaazul_contract_next_number(account)

Retorna o próximo número de contrato disponível.

contaazul_contract_write(data, account)

Cria um contrato. `data` é o payload em JSON. Required: data.

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 produto/serviço + tipo/quantidade/valor), data_validade, id_vendedor e composicao_de_valor (frete, desconto). Required: data.

contaazul_delete_budgets(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). Required: ids.

contaazul_delete_contract(id, ids, account)

Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution. Required: id.

contaazul_delete_settlement(id, ids, account)

Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution. Required: id.

contaazul_generate_charge(data, tipo, forcar, account, id_parcela, ids_parcelas, conta_bancaria, data_vencimento, maximo_parcelas, descricao_fatura, desconto_antecipado)

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 por LINK_PAGAMENTO); formas comuns como boleto/pix/cartão são normalizadas. `ids_parcelas` são UUIDs de PARCELA — pegue em contaazul_list_receivables (campo `id` de cada item) ou contaazul_get_installment, NÃO o id do evento financeiro. `conta_bancaria`, `descricao_fatura` e `data_vencimento` são exigidos pela API mas resolvidos automaticamente quando omitidos: a conta de cobranças ativa da empresa (passe `conta_bancaria` se houver mais de uma, via contaazul_list_financial_accounts com tipos=COBRANCAS_CONTA_AZUL) e a descrição/vencimento da própria parcela. Parcela que já tem cobrança ativa é PULADA (sai em `ignoradas`) — use forcar=true para emitir mesmo assim. `maximo_parcelas` só vale para LINK_PAGAMENTO. Retorna {solicitadas, emitidas:[{id_parcela,id,url,status}], ignoradas, erros} — `url` é o link da cobrança. Para consultar depois use contaazul_get_charge e para cancelar contaazul_cancel_charge. A API NÃO envia o e-mail de notificação da cobrança: isso só na tela do Conta Azul. Required: tipo.

contaazul_get_account_balance(id, ids, account)

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. Required: id.

contaazul_get_budget(id, ids, account)

Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution. Required: id.

contaazul_get_charge(id, ids, account)

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. Required: id.

contaazul_get_company(account)

Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).

contaazul_get_contract(id, ids, account)

Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution. Required: id.

contaazul_get_initial_balance(account, data_fim, data_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(id, ids, account)

Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution. Required: id.

contaazul_get_invoice_nfe(id, ids, account)

Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution. Required: id.

contaazul_get_person(id, ids, account)

Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution. Required: id.

contaazul_get_sale(id, ids, account)

Detalhe de uma venda por id. Bulk support: accepts ids for batched execution. Required: id.

contaazul_get_settlement(id, ids, account)

Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution. Required: id.

contaazul_list_accounts(account)

Lista as empresas Conta Azul vinculadas a este install (company_id, label).

contaazul_list_budgets(pagina, account, tamanho_pagina)

Lista orçamentos (cliente, número, total, situação, versão). Paginado.

contaazul_list_categories(tipo, pagina, account, tamanho_pagina)

Lista categorias financeiras (DRE).

contaazul_list_changed_events(pagina, account, data_fim, data_inicio, tamanho_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; use contaazul_get_installment para o detalhe.

contaazul_list_contracts(pagina, account, data_fim, cliente_id, cliente_ids, data_inicio, busca_textual, tamanho_pagina)

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 cliente_ids for batched execution.

contaazul_list_cost_centers(pagina, account, tamanho_pagina)

Lista centros de custo.

contaazul_list_financial_accounts(nome, tipos, pagina, account, apenas_ativo, tamanho_pagina)

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=["COBRANCAS_CONTA_AZUL"].

contaazul_list_installments(account, id_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_receivables / contaazul_list_payables. Required: id_evento.

contaazul_list_invoices_nfe(pagina, status, account, tamanho_pagina, data_emissao_fim, data_emissao_inicio)

Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.

contaazul_list_invoices_nfse(pagina, status, account, id_cliente, numero_venda, tamanho_pagina, tipo_negociacao, numero_rps_final, numero_nfse_final, numero_rps_inicial, data_competencia_de, numero_nfse_inicial, data_competencia_ate)

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). Outros filtros: id_cliente, numero_venda, status (PENDENTE, PRONTA_ENVIO, EMITIDA, CANCELADA…), tipo_negociacao (VENDA, CONTRATO), numero_nfse_inicial, numero_nfse_final, numero_rps_inicial, numero_rps_final.

contaazul_list_payables(pagina, status, account, tamanho_pagina, data_vencimento_de, data_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, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO).

contaazul_list_people(ativo, busca, pagina, account, tipo_perfil, tamanho_pagina)

Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.

contaazul_list_products(ativo, busca, pagina, account, tamanho_pagina)

Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.

contaazul_list_receivables(pagina, status, account, ids_clientes, tamanho_pagina, data_vencimento_de, data_vencimento_ate)

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_list_sales(pagina, account, data_fim, cliente_id, cliente_ids, data_inicio, status_venda, tamanho_pagina)

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(busca, pagina, account, tamanho_pagina)

Lista serviços cadastrados.

contaazul_list_settlements(id, ids, account)

Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution. Required: id.

contaazul_list_transfers(pagina, account, data_fim, data_inicio, tamanho_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). Paginado.

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, descricao, contato (UUID do fornecedor), conta_financeira (UUID), condicao_pagamento.parcelas[] (cada parcela leva detalhe_valor:{valor_bruto obrigatório; valor_liquido derivado se omitido} — os aliases valor_composicao e composicao_valor são normalizados automaticamente), rateio[] opcional. metodo_pagamento da parcela usa o enum EXATO da API (PIX_PAGAMENTO_INSTANTANEO, BOLETO_BANCARIO, TRANSFERENCIA_BANCARIA, CARTAO_CREDITO, CARTAO_DEBITO, DINHEIRO etc — formas curtas como PIX/BOLETO/TED são normalizadas). Retorna 202 + {protocolId,status} (assíncrono). Required: data.

contaazul_person_delete(id, ids, account)

Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution. Required: id.

contaazul_person_write_create(id, ids, data, 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 `data` (JSON) — a tool lê o cadastro atual e mescla (update parcial; campo com valor null limpa). Enums de escrita: tipo_pessoa = Física|Jurídica|Estrangeira; perfis = [{"tipo_perfil":"Cliente"|"Fornecedor"|"Transportadora"}] (variações de caixa/acento são normalizadas). No update, o Conta Azul valida o cadastro INTEIRO e pode exigir campos que o registro ainda não tem (ex.: codigo, rg, data_nascimento e inscricoes para pessoa Física) — o erro retornado diz qual falta; inclua-o no `data`. [Flattened action: create] Bulk support: accepts ids for batched execution. Required: data.

contaazul_person_write_update(id, ids, data, 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 `data` (JSON) — a tool lê o cadastro atual e mescla (update parcial; campo com valor null limpa). Enums de escrita: tipo_pessoa = Física|Jurídica|Estrangeira; perfis = [{"tipo_perfil":"Cliente"|"Fornecedor"|"Transportadora"}] (variações de caixa/acento são normalizadas). No update, o Conta Azul valida o cadastro INTEIRO e pode exigir campos que o registro ainda não tem (ex.: codigo, rg, data_nascimento e inscricoes para pessoa Física) — o erro retornado diz qual falta; inclua-o no `data`. [Flattened action: update] Bulk support: accepts ids for batched execution. Required: data.

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_products (/produto/busca) com filtro. Required: data.

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, contato (UUID do cliente — via contaazul_list_people), conta_financeira (UUID — via contaazul_list_financial_accounts), condicao_pagamento.parcelas[] (cada: descricao, data_vencimento YYYY-MM-DD, nota, conta_financeira UUID, detalhe_valor:{valor_bruto obrigatório; valor_liquido derivado se omitido} — os aliases de leitura valor_composicao (o que contaazul_get_installment devolve) e de baixa composicao_valor são normalizados automaticamente pro detalhe_valor, metodo_pagamento com o enum EXATO da API: PIX_PAGAMENTO_INSTANTANEO, BOLETO_BANCARIO, TRANSFERENCIA_BANCARIA, CARTAO_CREDITO, CARTAO_DEBITO, DINHEIRO, DEPOSITO_BANCARIO, DEBITO_AUTOMATICO etc — formas curtas comuns como PIX/BOLETO/TED são normalizadas). OPCIONAL: rateio[] (cada: id_categoria UUID via contaazul_list_categories, valor, rateio_centro_custo[]). Retorna 202 + {protocolId,status} (processamento assíncrono). Required: data.

contaazul_sale_cancel(id, ids, account)

Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution. Required: id.

contaazul_sale_write_create(id, ids, data, 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: accepts ids for batched execution. Required: data.

contaazul_sale_write_update(id, ids, data, 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: accepts ids for batched execution. Required: data.

contaazul_service_write(data, account)

Cria um serviço. `data` é JSON com nome, valor, etc. Required: data.

contaazul_settle_installment(id, ids, data, 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: data_pagamento (YYYY-MM-DD), composicao_valor {valor_bruto, multa, juros, desconto, taxa, valor_liquido}, conta_financeira (UUID em string, via contaazul_list_financial_accounts) e metodo_pagamento, enum EXATO da API: DINHEIRO, PIX_PAGAMENTO_INSTANTANEO, BOLETO_BANCARIO, TRANSFERENCIA_BANCARIA, CARTAO_CREDITO, CARTAO_DEBITO, CARTAO_CREDITO_VIA_LINK, CHEQUE, DEPOSITO_BANCARIO, CARTEIRA_DIGITAL, CASHBACK, CREDITO_LOJA, CREDITO_VIRTUAL, OUTRO (formas curtas como PIX, BOLETO, CARTAO ou TRANSFERENCIA dão 400); observacao é opcional. O campo `versao` (controle de concorrência) é buscado automaticamente. Retorna a baixa com id_reconciliacao. Bulk support: accepts ids for batched execution. Required: id, data.

contaazul_terminate_contract(id, ids, account)

Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution. Required: id.

contaazul_update_installment(id, ids, data, 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_liquido}, data_pagamento_esperado, metodo_pagamento, perda, nsu, pagamento_agendado, id_conta_financeira. O campo `versao` (controle de concorrência) é buscado automaticamente — não precisa passar. Para registrar pagamento/baixa use contaazul_settle_installment e para estornar use contaazul_delete_settlement. Bulk support: accepts ids for batched execution. Required: id, data.

contaazul_update_settlement(id, ids, data, 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 o mesmo enum de contaazul_settle_installment, observacao). O campo `versao` é buscado automaticamente. Bulk support: accepts ids for batched execution. Required: id, data.

marketplace(limit, query, action, mcp_id, message, tool_id, arguments, immediate, tier_slug, prompt_body, prompt_slug, prompt_tool, prompt_vars, conversation, prompt_title, request_name, cancel_reason, cancel_comment, prompt_targets, report_context, prompt_category, request_details, prompt_description)

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 (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

report_bug(context, message, conversation)

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Required: message.

show_version

Show the current MCP platform and adapter versions.

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.

Last successful function declaration observed on 2026-08-13. Source: https://api.mcp.ai/contaazul. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://api.mcp.ai/contaazul.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/douglac/contaazul-mcp
• Remote endpoint (streamable-http) — https://api.mcp.ai/contaazul

Related, by what their authors tagged them

• Frihet ERP — last commit 2026-08-06, shares accounting, erp, fintech
  AI-native ERP MCP: ES/EU fiscal compliance (VeriFactu/TicketBAI/Facturae), invoicing, tax, banking
• Banco MCP — last commit 2026-05-15, shares agent-skill, brasil, brazil
  Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.
• MCP Fiscal Brasil — last commit 2026-08-04, shares accounting, brasil, brazil
  Ferramentas fiscais brasileiras: CNPJ, NF-e, IBS/CBS, ICMS, Simples Nacional, NCM/CFOP. Sem API key.
• ERP Report Engine — last commit 2026-08-04, shares erp
  Read-only MCP for the SQL database behind an ERP: provably read-only guard, public benchmark.
• br.com.brasilnfe/fiscal — last commit 2026-06-12, shares brasil, nfe
  Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
• io.github.edsonvmendes/miniframe-tools — last commit 2026-07-24, shares brasil, brazil
  Brazilian tools for agents: Pix codes, CEP, CNPJ + web capture and PDF. Pay per call.
• mcp-fns-calc — last commit 2026-07-14, shares accounting, fintech
  Russian tax calculators (VAT, USN, NDFL) and FNS fiscal-status checks via MCP.
• com.apideck/mcp — last commit 2026-08-02, shares accounting
  Apideck Unified API MCP — 330 tools across 200+ SaaS connectors (accounting, CRM, HRIS, ATS).
• QuickBooks Online MCP Server — last commit 2026-07-26, shares accounting
  QuickBooks Online MCP server for invoices, customers, and payments. OAuth 2.1 + PKCE, stdio/HTTP.
• ai.dataecho/mcp — last commit 2026-07-04, shares agent-skill
  Deploy files, sites, and Dockerfile apps to live URLs + private drives for agent memory.

These share tags the maintainers applied themselves, such as accounting, erp, fintech, agent-skill. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: accounting, agent-skill, ai, ai-agents, anthropic, brasil, brazil, claude, conta-azul, contaazul, contabilidade, cursor, erp, finance, fintech, llm, mcp, model-context-protocol, nfe, skills-sh.