MCP server

Conta Azul MCP

io.github.douglac/contaazul-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

58

Token cost

About 10,772 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.contaazul-mcp]
url = "https://api.mcp.ai/contaazul"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"contaazul-mcp":{"type":"http","url":"https://api.mcp.ai/contaazul"}}}

Antigravity

agy mcp add contaazul-mcp https://api.mcp.ai/contaazul

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"contaazul-mcp","server_url":"https://api.mcp.ai/contaazul","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"contaazul-mcp","server_url":"https://api.mcp.ai/contaazul"}

Tools

• authenticate ~144 tokens
  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
• connect ~98 tokens
  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 Moves money · ~159 tokens
  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_contract_next_number ~67 tokens
  Retorna o próximo número de contrato disponível.
• contaazul_contract_write ~78 tokens
  Cria um contrato. `data` é o payload em JSON.
• contaazul_create_budget ~146 tokens
  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 Deletes data · ~114 tokens
  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 Deletes data · ~111 tokens
  Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.
• contaazul_delete_settlement Deletes data · ~120 tokens
  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 Moves money · ~560 tokens
  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_account_balance ~126 tokens
  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 ~111 tokens
  Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.
• contaazul_get_charge ~152 tokens
  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_get_company ~72 tokens
  Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
• contaazul_get_contract ~118 tokens
  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 ~120 tokens
  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 ~101 tokens
  Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.
• contaazul_get_invoice_nfe ~100 tokens
  Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
• contaazul_get_person ~100 tokens
  Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
• contaazul_get_sale ~99 tokens
  Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
• contaazul_get_settlement ~107 tokens
  Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
• contaazul_list_accounts ~73 tokens
  Lista as empresas Conta Azul vinculadas a este install (company_id, label).
• contaazul_list_budgets ~89 tokens
  Lista orçamentos (cliente, número, total, situação, versão). Paginado.
• contaazul_list_categories ~87 tokens
  Lista categorias financeiras (DRE).
• contaazul_list_changed_events ~153 tokens
  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 ~218 tokens
  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: accept
• contaazul_list_cost_centers ~77 tokens
  Lista centros de custo.
• contaazul_list_financial_accounts ~195 tokens
  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_list_installments ~129 tokens
  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_list_invoices_nfe ~301 tokens
  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_list_invoices_nfse ~301 tokens
  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_list_payables ~211 tokens
  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_list_people ~141 tokens
  Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.
• contaazul_list_products ~106 tokens
  Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.
• contaazul_list_receivables ~187 tokens
  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_sale_items ~128 tokens
  Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.
• contaazul_list_sales ~622 tokens
  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_services ~84 tokens
  Lista serviços cadastrados.
• contaazul_list_settlements ~109 tokens
  Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.
• contaazul_list_transfers ~140 tokens
  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 ~371 tokens
  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_person_delete Deletes data · ~110 tokens
  Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
• contaazul_person_write_create ~330 tokens
  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 ~330 tokens
  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_product_write ~125 tokens
  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_receivable_create ~429 tokens
  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_sale_cancel ~108 tokens
  Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
• contaazul_sale_write_create ~308 tokens
  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 ~308 tokens
  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_service_write ~79 tokens
  Cria um serviço. `data` é JSON com nome, valor, etc.
• contaazul_settle_installment ~337 tokens
  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_terminate_contract ~111 tokens
  Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.
• contaazul_update_installment ~348 tokens
  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_update_settlement ~183 tokens
  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: a
• marketplace ~888 tokens
  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
• report_bug ~114 tokens
  Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
• show_version ~55 tokens
  Show the current MCP platform and adapter versions.
• toolkit_info ~84 tokens
  Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Browse

• GitHub tools
• Azul tools
• GitHub and code hosting

Related MCP servers

• Cakto
  Read your Cakto sales: orders, revenue analytics, subscriptions, churn, customers and products.
• Kommo
  Kommo CRM (formerly amoCRM), the conversation-first sales CRM (WhatsApp, Instagram, Telegram) used b
• Poupa AI
  Personal finance by Poupa AI. Read balance grouped by bank/category/card/month, transactions filtere
• GestãoClick
  GestãoClick ERP (business management for SMBs) via the official API: customers, suppliers, products
• Organizze
  Your Organizze finances in natural language: consolidated balances, monthly overview, transaction se
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Conta Simples
  Business finance on Conta Simples, bank and card statements, corporate cards (list/block/unblock), c
• FalaZuki Finance BR
  Cálculos e regras financeiras do Brasil com fonte e vigência em cada resposta.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.douglac/contaazul-mcp.svg)](https://aptlynx.net/servers/io.github.douglac/contaazul-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents