Skip to content

Conta Azul MCP

by douglac · remote · no sign-in to list tools · v0.1.0 · published by GitHub user douglac

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

Deletes · 7Final · 1Changes · 17
CompareRegistry entry

58 tools: 7 can delete or cancel things, 1 do something that can't be undone, 17 change things and 33 only read.

Scanned Oct 21, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

2 info
  • Infoconnect

    The description mentions "credentials".

    Matched text

    description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."

    What this check looks for
  • Infomarketplace

    The description mentions "credential".

    Matched text

    description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

58 tools

Deletes or cancels 7Claude Code: deny
  • contaazul_cancel_chargeCANCELA uma cobrança já emitida (boleto/pix/link deixa de ser pagável).No findings

    Why it is in this group

    • The name "contaazul_cancel_charge" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_cancel_charge
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_delete_budgetsExclui orçamentos em lote por id.No findings

    Why it is in this group

    • The name "contaazul_delete_budgets" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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).

    Annotations the server declares

    • title: contaazul_delete_budgets
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_delete_contractRemove um contrato por id.No findings

    Why it is in this group

    • The name "contaazul_delete_contract" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_delete_contract
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_delete_settlementEstorna (remove) uma baixa por id.No findings

    Why it is in this group

    • The name "contaazul_delete_settlement" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_delete_settlement
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_person_deleteRemove uma pessoa por id.No findings

    Why it is in this group

    • The name "contaazul_person_delete" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_person_delete
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_sale_cancelCancela uma venda.No findings

    Why it is in this group

    • The name "contaazul_sale_cancel" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_sale_cancel
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_terminate_contractEncerra um contrato por id.No findings

    Why it is in this group

    • The name "contaazul_terminate_contract" says "terminate": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_terminate_contract
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
Can't be undone 1Claude Code: ask
  • contaazul_generate_chargeGera cobrança (boleto, pix ou link de pagamento) para uma ou mais PARCELAS de contas a receber.No findings

    Why it is in this group

    • The name "contaazul_generate_charge" says "generate": a word for a change.
    • The name "contaazul_generate_charge" also says "charge": a word that usually means money moves, which cannot be taken back.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_generate_charge
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
Changes things 17Claude Code: ask
  • authenticateMCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Authenticate
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_contract_next_numberRetorna o próximo número de contrato disponível.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Retorna o próximo número de contrato disponível.

    Annotations the server declares

    • title: contaazul_contract_next_number
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_contract_writeCria um contrato.No findings

    Why it is in this group

    • The name "contaazul_contract_write" says "write": a word for a change.
    Description, as the server wrote it
    Cria um contrato. `data` é o payload em JSON.

    Annotations the server declares

    • title: contaazul_contract_write
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_create_budgetCria um orçamento.No findings

    Why it is in this group

    • The name "contaazul_create_budget" says "create": a word for a change.
    Description, as the server wrote it
    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).

    Annotations the server declares

    • title: contaazul_create_budget
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_payable_createCria um evento financeiro de conta a pagar.No findings

    Why it is in this group

    • The name "contaazul_payable_create" says "create": a word for a change.
    Description, as the server wrote it
    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).

    Annotations the server declares

    • title: contaazul_payable_create
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_person_write_createCria ou atualiza uma pessoa.No findings

    Why it is in this group

    • The name "contaazul_person_write_create" says "write": a word for a change.
    Description, as the server wrote it
    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 trocar só o email). Enums de escrita: tipo_pessoa = Física|Jurídica|Estrangeira; perfis = [{"tipo_perfil":"Cliente"|"Fornecedor"|"Transportadora"}] (variações de caixa/acento são normalizadas). Único campo fora do update parcial é `outros_contatos`: mudá-lo obriga a substituição integral do cadastro, e aí o Conta Azul exige codigo, data_nascimento, observacao, telefone_celular e telefone_comercial preenchidos — o erro retornado diz qual falta; inclua-o no `data`. [Flattened action: create] Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_person_write_create
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_person_write_updateCria ou atualiza uma pessoa.No findings

    Why it is in this group

    • The name "contaazul_person_write_update" says "write": a word for a change.
    Description, as the server wrote it
    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 trocar só o email). Enums de escrita: tipo_pessoa = Física|Jurídica|Estrangeira; perfis = [{"tipo_perfil":"Cliente"|"Fornecedor"|"Transportadora"}] (variações de caixa/acento são normalizadas). Único campo fora do update parcial é `outros_contatos`: mudá-lo obriga a substituição integral do cadastro, e aí o Conta Azul exige codigo, data_nascimento, observacao, telefone_celular e telefone_comercial preenchidos — o erro retornado diz qual falta; inclua-o no `data`. [Flattened action: update] Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_person_write_update
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_product_writeCria um produto (nome + valor_venda obrigatórios em `data` JSON).No findings

    Why it is in this group

    • The name "contaazul_product_write" says "write": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_product_write
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_receivable_createCria um evento financeiro de conta a receber.No findings

    Why it is in this group

    • The name "contaazul_receivable_create" says "create": a word for a change.
    Description, as the server wrote it
    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).

    Annotations the server declares

    • title: contaazul_receivable_create
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_sale_write_createCria ou atualiza venda.No findings

    Why it is in this group

    • The name "contaazul_sale_write_create" says "write": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_sale_write_create
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_sale_write_updateCria ou atualiza venda.No findings

    Why it is in this group

    • The name "contaazul_sale_write_update" says "write": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_sale_write_update
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_service_writeCria um serviço.No findings

    Why it is in this group

    • The name "contaazul_service_write" says "write": a word for a change.
    Description, as the server wrote it
    Cria um serviço. `data` é JSON com nome, valor, etc.

    Annotations the server declares

    • title: contaazul_service_write
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_settle_installmentRegistra a baixa (recebimento/pagamento) de uma parcela.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_settle_installment
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_update_installmentAtualiza campos de uma parcela (PATCH).No findings

    Why it is in this group

    • The name "contaazul_update_installment" says "update": a word for a change.
    Description, as the server wrote it
    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. NÃO é editável aqui: `rateio`/`rateio_centro_custo` (categoria e centro de custo só entram na CRIAÇÃO do lançamento, via rateio[] do contaazul_payable_create / contaazul_receivable_create; o Conta Azul não deixa alterar depois). Campo fora da lista é RECUSADO com erro em vez de ser enviado, porque a API responde 200 e incrementa a versão descartando o campo em silêncio. Para registrar pagamento/baixa use contaazul_settle_installment e para estornar use contaazul_delete_settlement. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_update_installment
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • contaazul_update_settlementAtualiza uma baixa (PATCH).No findings

    Why it is in this group

    • The name "contaazul_update_settlement" says "update": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_update_settlement
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • marketplaceThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them.1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    Findings

    • Info

      The description mentions "credential".

      Matched text

      description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Marketplace
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • report_bugReport a bug, missing feature, or send feedback.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

    Annotations the server declares

    • title: Report Bug
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
Only reads 33Claude Code: allow
  • connectReturns connection status and URLs.1 finding

    Why it is in this group

    • The description's first verb is "return": a word for reading.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Connection Status
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_account_balanceSaldo atual de uma conta financeira por id (banco/caixa/cartão).No findings

    Why it is in this group

    • The name "contaazul_get_account_balance" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_get_account_balance
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_budgetDetalhe de um orçamento por id (itens, cliente, composição de valor).No findings

    Why it is in this group

    • The name "contaazul_get_budget" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_budget
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_chargeDetalhe de uma cobrança emitida por id (o `id` devolvido em contaazul_generate_charge).No findings

    Why it is in this group

    • The name "contaazul_get_charge" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_get_charge
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_companyDados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).No findings

    Why it is in this group

    • The name "contaazul_get_company" says "get": a word for reading.
    Description, as the server wrote it
    Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).

    Annotations the server declares

    • title: contaazul_get_company
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_contractDetalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor).No findings

    Why it is in this group

    • The name "contaazul_get_contract" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_contract
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_initial_balanceSaldos iniciais das contas financeiras por período.No findings

    Why it is in this group

    • The name "contaazul_get_initial_balance" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_get_initial_balance
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_installmentDetalhe de uma parcela por id.No findings

    Why it is in this group

    • The name "contaazul_get_installment" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_installment
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_invoice_nfeDetalhe de uma NF-e por id.No findings

    Why it is in this group

    • The name "contaazul_get_invoice_nfe" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_invoice_nfe
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_personDetalhe de uma pessoa por id.No findings

    Why it is in this group

    • The name "contaazul_get_person" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_person
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_saleDetalhe de uma venda por id.No findings

    Why it is in this group

    • The name "contaazul_get_sale" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_sale
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_get_settlementDetalhe de uma baixa por id.No findings

    Why it is in this group

    • The name "contaazul_get_settlement" says "get": a word for reading.
    Description, as the server wrote it
    Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_get_settlement
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_accountsLista as empresas Conta Azul vinculadas a este install (company_id, label).No findings

    Why it is in this group

    • The name "contaazul_list_accounts" says "list": a word for reading.
    Description, as the server wrote it
    Lista as empresas Conta Azul vinculadas a este install (company_id, label).

    Annotations the server declares

    • title: contaazul_list_accounts
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_budgetsLista orçamentos (cliente, número, total, situação, versão).No findings

    Why it is in this group

    • The name "contaazul_list_budgets" says "list": a word for reading.
    Description, as the server wrote it
    Lista orçamentos (cliente, número, total, situação, versão). Paginado.

    Annotations the server declares

    • title: contaazul_list_budgets
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_categoriesLista categorias financeiras (DRE).No findings

    Why it is in this group

    • The name "contaazul_list_categories" says "list": a word for reading.
    Description, as the server wrote it
    Lista categorias financeiras (DRE).

    Annotations the server declares

    • title: contaazul_list_categories
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_changed_eventsLista os IDs de eventos financeiros alterados num período (para sync incremental / conciliação).No findings

    Why it is in this group

    • The name "contaazul_list_changed_events" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_list_changed_events
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_contractsLista 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).No findings

    Why it is in this group

    • The name "contaazul_list_contracts" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_list_contracts
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_cost_centersLista centros de custo.No findings

    Why it is in this group

    • The name "contaazul_list_cost_centers" says "list": a word for reading.
    Description, as the server wrote it
    Lista centros de custo.

    Annotations the server declares

    • title: contaazul_list_cost_centers
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_financial_accountsLista contas financeiras (banco, caixa, cartão).No findings

    Why it is in this group

    • The name "contaazul_list_financial_accounts" says "list": a word for reading.
    Description, as the server wrote it
    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"].

    Annotations the server declares

    • title: contaazul_list_financial_accounts
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_installmentsLista as parcelas de UM evento financeiro (passe `id_evento`).No findings

    Why it is in this group

    • The name "contaazul_list_installments" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_list_installments
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_invoices_nfeLista notas fiscais emitidas (NF-e).No findings

    Why it is in this group

    • The name "contaazul_list_invoices_nfe" says "list": a word for reading.
    Description, as the server wrote it
    Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.

    Annotations the server declares

    • title: contaazul_list_invoices_nfe
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_invoices_nfseLista NFS-e (notas fiscais de serviço) por filtro.No findings

    Why it is in this group

    • The name "contaazul_list_invoices_nfse" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_list_invoices_nfse
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_payablesLista contas a pagar (parcelas de despesa).No findings

    Why it is in this group

    • The name "contaazul_list_payables" says "list": a word for reading.
    Description, as the server wrote it
    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 aqui = pago) e o mesmo formato de item — parecido com list_receivables, mas são despesas.

    Annotations the server declares

    • title: contaazul_list_payables
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_peopleLista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas.No findings

    Why it is in this group

    • The name "contaazul_list_people" says "list": a word for reading.
    Description, as the server wrote it
    Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.

    Annotations the server declares

    • title: contaazul_list_people
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_productsLista produtos cadastrados.No findings

    Why it is in this group

    • The name "contaazul_list_products" says "list": a word for reading.
    Description, as the server wrote it
    Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.

    Annotations the server declares

    • title: contaazul_list_products
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_receivablesLista contas a receber (parcelas de receita).No findings

    Why it is in this group

    • The name "contaazul_list_receivables" says "list": a word for reading.
    Description, as the server wrote it
    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).

    Annotations the server declares

    • title: contaazul_list_receivables
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_sale_itemsItens (produtos/serviços, quantidade, valor) de uma ou mais vendas.No findings

    Why it is in this group

    • The name "contaazul_list_sale_items" says "list": a word for reading.
    Description, as the server wrote it
    Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.

    Annotations the server declares

    • title: contaazul_list_sale_items
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_salesLista vendas (GET /venda/busca).No findings

    Why it is in this group

    • The name "contaazul_list_sales" says "list": a word for reading.
    Description, as the server wrote it
    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 (ex.: aprovado, em_andamento, faturado, cancelado, orcamento), termo_busca, ordenação por numero/cliente/data. Paginação: pagina + tamanho_pagina; a resposta traz total_itens, totais e quantidades por situação. Bulk support: accepts cliente_ids for batched execution.

    Annotations the server declares

    • title: contaazul_list_sales
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_servicesLista serviços cadastrados.No findings

    Why it is in this group

    • The name "contaazul_list_services" says "list": a word for reading.
    Description, as the server wrote it
    Lista serviços cadastrados.

    Annotations the server declares

    • title: contaazul_list_services
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_settlementsLista as baixas de uma parcela.No findings

    Why it is in this group

    • The name "contaazul_list_settlements" says "list": a word for reading.
    Description, as the server wrote it
    Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: contaazul_list_settlements
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contaazul_list_transfersLista transferências entre contas financeiras por período (conciliação).No findings

    Why it is in this group

    • The name "contaazul_list_transfers" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: contaazul_list_transfers
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • show_versionShow the current MCP platform and adapter versions.No findings

    Why it is in this group

    • The name "show_version" says "show": a word for reading.
    Description, as the server wrote it
    Show the current MCP platform and adapter versions.

    Annotations the server declares

    • title: Show Version
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

    Annotations the server declares

    • title: Toolkit Info
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__contaazul__contaazul_list_accounts",
      "mcp__contaazul__contaazul_get_company",
      "mcp__contaazul__contaazul_list_people",
      "mcp__contaazul__contaazul_get_person",
      "mcp__contaazul__contaazul_list_products",
      "mcp__contaazul__contaazul_list_services",
      "mcp__contaazul__contaazul_list_sales",
      "mcp__contaazul__contaazul_list_sale_items",
      "mcp__contaazul__contaazul_get_sale",
      "mcp__contaazul__contaazul_list_contracts",
      "mcp__contaazul__contaazul_list_receivables",
      "mcp__contaazul__contaazul_list_payables",
      "mcp__contaazul__contaazul_list_installments",
      "mcp__contaazul__contaazul_get_installment",
      "mcp__contaazul__contaazul_list_financial_accounts",
      "mcp__contaazul__contaazul_get_account_balance",
      "mcp__contaazul__contaazul_list_categories",
      "mcp__contaazul__contaazul_list_cost_centers",
      "mcp__contaazul__contaazul_list_invoices_nfe",
      "mcp__contaazul__contaazul_get_invoice_nfe",
      "mcp__contaazul__contaazul_list_invoices_nfse",
      "mcp__contaazul__contaazul_list_settlements",
      "mcp__contaazul__contaazul_get_settlement",
      "mcp__contaazul__contaazul_list_transfers",
      "mcp__contaazul__contaazul_get_initial_balance",
      "mcp__contaazul__contaazul_list_changed_events",
      "mcp__contaazul__contaazul_get_charge",
      "mcp__contaazul__contaazul_get_contract",
      "mcp__contaazul__contaazul_list_budgets",
      "mcp__contaazul__contaazul_get_budget",
      "mcp__contaazul__show_version",
      "mcp__contaazul__connect",
      "mcp__contaazul__toolkit_info"
    ],
    "ask": [
      "mcp__contaazul__contaazul_person_write_create",
      "mcp__contaazul__contaazul_person_write_update",
      "mcp__contaazul__contaazul_product_write",
      "mcp__contaazul__contaazul_service_write",
      "mcp__contaazul__contaazul_sale_write_create",
      "mcp__contaazul__contaazul_sale_write_update",
      "mcp__contaazul__contaazul_contract_write",
      "mcp__contaazul__contaazul_receivable_create",
      "mcp__contaazul__contaazul_payable_create",
      "mcp__contaazul__contaazul_update_installment",
      "mcp__contaazul__contaazul_settle_installment",
      "mcp__contaazul__contaazul_update_settlement",
      "mcp__contaazul__contaazul_generate_charge",
      "mcp__contaazul__contaazul_contract_next_number",
      "mcp__contaazul__contaazul_create_budget",
      "mcp__contaazul__report_bug",
      "mcp__contaazul__marketplace",
      "mcp__contaazul__authenticate"
    ],
    "deny": [
      "mcp__contaazul__contaazul_person_delete",
      "mcp__contaazul__contaazul_sale_cancel",
      "mcp__contaazul__contaazul_delete_settlement",
      "mcp__contaazul__contaazul_cancel_charge",
      "mcp__contaazul__contaazul_terminate_contract",
      "mcp__contaazul__contaazul_delete_contract",
      "mcp__contaazul__contaazul_delete_budgets"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as contaazul. Review it before you use it.