Conta Azul MCP
REMOTE · API.MCP.AI
Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.
Available components
Last scanned (16 hours ago)
Scores higher than 53% of remote servers
Reachable. Last reached 21 Nov 2026.
Category Finance and Payments
Recent critical change
Authorization (4 Sept 2026). See the changelog before you install this server.
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: this server exposes a tool marked destructive (contaazul_person_delete) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated. View diagnostics → Unverified
- HTTPS enforcement could not be verified: the plaintext port answered with HTTP 406, which proves neither a plaintext path nor enforcement. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability61
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 8649 tokens (~149/item across 58 items; 58 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage67
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
Tool Safety97
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 7 of 8 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "contaazul_get_charge" implies "charge" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Partial
- An AI judge read all 59 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (11)
- TLS certificate
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (2)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Authorization in Endpoint SecurityAuthorisation not fully verified: this server exposes a tool marked destructive (contaazul_person_delete) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated.
- HTTPS in Endpoint SecurityHTTPS enforcement could not be verified: the plaintext port answered with HTTP 406, which proves neither a plaintext path nor enforcement.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.460 → 0.9.467 functional
- 20 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.459 → 0.9.460 functional
- 19 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.454 → 0.9.459 functional
- 18 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.452 → 0.9.454 functional
- 17 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Tool “contaazul_list_payables” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_receivables” rewrote its description, which is the text the model reads security
- Server version: 0.9.450 → 0.9.452 functional
- 16 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.449 → 0.9.450 functional
- 15 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.442 → 0.9.449 functional
- 14 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Tool “contaazul_get_installment” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_budgets” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_categories” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_contracts” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_cost_centers” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_payables” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_people” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_products” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_receivables” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_sales” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_services” rewrote its description, which is the text the model reads security
- Tool “contaazul_list_transfers” rewrote its description, which is the text the model reads security
- Server version: 0.9.429 → 0.9.442 functional
- “contaazul_list_payables” added an optional parameter “data_competencia_ate” cosmetic
- “contaazul_list_payables” added an optional parameter “data_competencia_de” cosmetic
- “contaazul_list_payables” added an optional parameter “data_pagamento_ate” cosmetic
- “contaazul_list_payables” added an optional parameter “data_pagamento_de” cosmetic
- “contaazul_list_payables” added an optional parameter “descricao” cosmetic
- “contaazul_list_payables” added an optional parameter “ids_categorias” cosmetic
- “contaazul_list_payables” added an optional parameter “ids_centros_de_custo” cosmetic
- “contaazul_list_payables” added an optional parameter “ids_contas_financeiras” cosmetic
- “contaazul_list_payables” added an optional parameter “valor_ate” cosmetic
- “contaazul_list_payables” added an optional parameter “valor_de” cosmetic
- “contaazul_list_receivables” added an optional parameter “data_competencia_ate” cosmetic
- “contaazul_list_receivables” added an optional parameter “data_competencia_de” cosmetic
- “contaazul_list_receivables” added an optional parameter “data_pagamento_ate” cosmetic
- “contaazul_list_receivables” added an optional parameter “data_pagamento_de” cosmetic
- “contaazul_list_receivables” added an optional parameter “descricao” cosmetic
- “contaazul_list_receivables” added an optional parameter “ids_categorias” cosmetic
- “contaazul_list_receivables” added an optional parameter “ids_centros_de_custo” cosmetic
- “contaazul_list_receivables” added an optional parameter “ids_contas_financeiras” cosmetic
- “contaazul_list_receivables” added an optional parameter “valor_ate” cosmetic
- “contaazul_list_receivables” added an optional parameter “valor_de” cosmetic
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://api.mcp.ai/contaazul
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mcp.ai | CN=WE1,O=Google Trust Services,C=US | 28 Sept 2026 | 27 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | 1bf4d405299e078a0e62ff16cded599b |
| SANs: mcp.ai, *.mcp.ai | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of api.mcp.ai. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| ai. | DS published | 1814 | 8 | Verified |
| mcp.ai. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.mcp.ai/contaazul | Verified | 200 | |
| http (plaintext) | http://api.mcp.ai/contaazul | Inconclusive | 406 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
authenticate ~99
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.
| Name | Type | Req | Description |
|---|---|---|---|
| token | string | – | – |
No output schema declared.
No examples provided.
connect ~42
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
contaazul_cancel_charge ~103
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_contract_next_number ~28
Retorna o próximo número de contrato disponível.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
No output schema declared.
No examples provided.
contaazul_contract_write ~39
Cria um contrato. `data` é o payload em JSON.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
No output schema declared.
No examples provided.
contaazul_create_budget ~104
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).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
No output schema declared.
No examples provided.
contaazul_delete_budgets ~71
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).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| ids | array | yes | – |
No output schema declared.
No examples provided.
contaazul_delete_contract ~57
Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_delete_settlement ~71
Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_generate_charge ~464
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| conta_bancaria | string | – | – |
| data | string | – | – |
| data_vencimento | string | – | – |
| desconto_antecipado | object | – | – |
| descricao_fatura | string | – | – |
| forcar | boolean | – | – |
| id_parcela | string | – | – |
| ids_parcelas | array | – | – |
| maximo_parcelas | number | – | – |
| tipo | string | yes | – |
No output schema declared.
No examples provided.
contaazul_get_account_balance ~74
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_budget ~60
Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_charge ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_company ~35
Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
No output schema declared.
No examples provided.
contaazul_get_contract ~63
Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_initial_balance ~77
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_fim | string | – | – |
| data_inicio | string | – | – |
No output schema declared.
No examples provided.
contaazul_get_installment ~83
Detalhe de uma parcela por id. `id_conta_financeira` vem preenchido com o id de `conta_financeira` quando a API o devolve nulo. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_invoice_nfe ~54
Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_person ~51
Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_sale ~51
Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_get_settlement ~61
Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_list_accounts ~34
Lista as empresas Conta Azul vinculadas a este install (company_id, label).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
No output schema declared.
No examples provided.
contaazul_list_budgets ~82
Lista orçamentos (cliente, número, total, situação, versão). Paginado: pagina + tamanho_pagina (10, 20, 50, 100, 200, 500 ou 1000).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_categories ~68
Lista categorias financeiras (DRE). Paginação: pagina + tamanho_pagina (10, 20, 50 ou 100).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
| tipo | string | – | – |
No output schema declared.
No examples provided.
contaazul_list_changed_events ~107
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_fim | string | – | – |
| data_inicio | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_contracts ~163
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 (10, 20 ou 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| busca_textual | string | – | – |
| cliente_id | string | – | – |
| cliente_ids | array | – | – |
| data_fim | string | – | – |
| data_inicio | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_cost_centers ~61
Lista centros de custo. Paginação: pagina + tamanho_pagina (10, 20, 50 ou 100).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_financial_accounts ~164
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"].
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| apenas_ativo | boolean | – | – |
| nome | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
| tipos | array | – | – |
No output schema declared.
No examples provided.
contaazul_list_installments ~82
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id_evento | string | yes | – |
No output schema declared.
No examples provided.
contaazul_list_invoices_nfe ~276
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; janela maior (ex.: um mês) é consultada em partes de 15 dias e devolvida junta (todas as páginas, campo `janelas`). Outros filtros: documento_tomador (CPF/CNPJ), numero_nota, id_venda. Paginação (só em janela de até 15 dias): pagina + tamanho_pagina (10, 20, 50 ou 100).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_emissao_fim | string | – | – |
| data_emissao_inicio | string | – | – |
| data_final | string | – | – |
| data_inicial | string | – | – |
| documento_tomador | string | – | – |
| id_venda | string | – | – |
| numero_nota | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_invoices_nfse ~265
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, PRONTA_ENVIO, EMITIDA, CANCELADA…), tipo_negociacao (VENDA, CONTRATO), numero_nfse_inicial, numero_nfse_final, numero_rps_inicial, numero_rps_final.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_competencia_ate | string | – | – |
| data_competencia_de | string | – | – |
| id_cliente | string | – | – |
| numero_nfse_final | number | – | – |
| numero_nfse_inicial | number | – | – |
| numero_rps_final | number | – | – |
| numero_rps_inicial | number | – | – |
| numero_venda | string | – | – |
| pagina | number | – | – |
| status | string | – | – |
| tamanho_pagina | number | – | – |
| tipo_negociacao | string | – | – |
No output schema declared.
No examples provided.
contaazul_list_payables ~532
Lista contas a pagar (parcelas de despesa). Filtros: tamanho_pagina (10, 20, 50 ou 100; outro valor é arredondado para baixo), pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD). A API do Conta Azul aceita no máximo 365 dias de vencimento por consulta; intervalos maiores (até 5 anos) são divididos automaticamente em janelas de 365 dias e o resultado volta junto, paginado e em ordem de vencimento (campo janelas_vencimento). Acima de 5 anos a chamada é recusada. Se o vencimento for omitido: com filtro de pagamento ou competência, usa esse período com 180 dias de folga de cada lado; sem filtro nenhum, usa de 182 dias atrás até 182 dias à frente; com só um lado, o outro fica a 365 dias. data_pagamento_de, data_pagamento_ate (YYYY-MM-DD, data em que foi pago; regime de caixa, pode ser usado sozinho, sem vencimento), data_competencia_de, data_competencia_ate (YYYY-MM-DD), ids_contas_financeiras (UUIDs, via contaazul_list_financial_accounts; o item da lista não traz a conta, então para separar totais por conta filtre uma conta por chamada), ids_categorias, ids_centros_de_custo, descricao, valor_de, valor_ate, 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_competencia_ate | string | – | – |
| data_competencia_de | string | – | – |
| data_pagamento_ate | string | – | – |
| data_pagamento_de | string | – | – |
| data_vencimento_ate | string | – | – |
| data_vencimento_de | string | – | – |
| descricao | string | – | – |
| ids_categorias | – | – | – |
| ids_centros_de_custo | – | – | – |
| ids_contas_financeiras | – | – | – |
| pagina | number | – | – |
| status | string | – | – |
| tamanho_pagina | number | – | – |
| valor_ate | number | – | – |
| valor_de | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_people ~107
Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina (10, 20, 50 ou 100), pagina, busca (nome/documento), tipo_perfil, ativo.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| ativo | boolean | – | – |
| busca | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
| tipo_perfil | string | – | – |
No output schema declared.
No examples provided.
contaazul_list_products ~78
Lista produtos cadastrados. Filtros: tamanho_pagina (10, 20, 50 ou 100), pagina, busca, ativo.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| ativo | boolean | – | – |
| busca | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_receivables ~509
Lista contas a receber (parcelas de receita). Filtros: tamanho_pagina (10, 20, 50 ou 100; outro valor é arredondado para baixo), pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD). A API do Conta Azul aceita no máximo 365 dias de vencimento por consulta; intervalos maiores (até 5 anos) são divididos automaticamente em janelas de 365 dias e o resultado volta junto, paginado e em ordem de vencimento (campo janelas_vencimento). Acima de 5 anos a chamada é recusada. Se o vencimento for omitido: com filtro de pagamento ou competência, usa esse período com 180 dias de folga de cada lado; sem filtro nenhum, usa de 182 dias atrás até 182 dias à frente; com só um lado, o outro fica a 365 dias. data_pagamento_de, data_pagamento_ate (YYYY-MM-DD, data em que foi recebido; regime de caixa, pode ser usado sozinho, sem vencimento), data_competencia_de, data_competencia_ate (YYYY-MM-DD), ids_contas_financeiras (UUIDs, via contaazul_list_financial_accounts; o item da lista não traz a conta, então para separar totais por conta filtre uma conta por chamada), ids_categorias, ids_centros_de_custo, descricao, valor_de, valor_ate, status (PERDIDO, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO), ids_clientes (UUIDs dos clientes).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_competencia_ate | string | – | – |
| data_competencia_de | string | – | – |
| data_pagamento_ate | string | – | – |
| data_pagamento_de | string | – | – |
| data_vencimento_ate | string | – | – |
| data_vencimento_de | string | – | – |
| descricao | string | – | – |
| ids_categorias | – | – | – |
| ids_centros_de_custo | – | – | – |
| ids_clientes | – | – | – |
| ids_contas_financeiras | – | – | – |
| pagina | number | – | – |
| status | string | – | – |
| tamanho_pagina | number | – | – |
| valor_ate | number | – | – |
| valor_de | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_sale_items ~79
Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| ids_venda | array | yes | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_sales ~501
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, proposal, proposal_accepted, proposal_refused, scheduled, committed; sinônimos em_andamento, aprovado, faturado, cancelado, orcamento, orcamento_aceito, orcamento_recusado e agendado são convertidos), termo_busca, ordenação por numero/cliente/data. Paginação: pagina + tamanho_pagina (10, 20, 50, 100, 200, 500 ou 1000); a resposta traz total_itens, totais e quantidades por situação. data_alteracao_de e data_alteracao_ate só valem juntos na API: informe os dois; se vier só um, o outro é completado (sem _ate = agora; sem _de = 30 dias antes do _ate). Bulk support: accepts cliente_ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| campo_ordenado_ascendente | string | – | – |
| campo_ordenado_descendente | string | – | – |
| cliente_id | string | – | – |
| cliente_ids | array | – | – |
| data_alteracao_ate | string | – | – |
| data_alteracao_de | string | – | – |
| data_criacao_ate | string | – | – |
| data_criacao_de | string | – | – |
| data_fim | string | – | – |
| data_inicio | string | – | – |
| ids_categorias | array | – | – |
| ids_clientes | array | – | – |
| ids_produtos | array | – | – |
| ids_vendedores | array | – | – |
| numeros | array | – | – |
| origens | array | – | – |
| pagina | number | – | – |
| situacoes | array | – | – |
| status_venda | string | – | – |
| tamanho_pagina | number | – | – |
| termo_busca | string | – | – |
| tipos | array | – | – |
| totais | string | – | – |
No output schema declared.
No examples provided.
contaazul_list_services ~66
Lista serviços cadastrados. Paginação: pagina + tamanho_pagina (10, 20, 50 ou 100).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| busca | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_list_settlements ~61
Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_list_transfers ~126
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: pagina + tamanho_pagina (10, 20, 50, 100, 200, 500 ou 1000).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data_fim | string | – | – |
| data_inicio | string | – | – |
| pagina | number | – | – |
| tamanho_pagina | number | – | – |
No output schema declared.
No examples provided.
contaazul_payable_create ~321
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_financial_accounts), data_competencia (YYYY-MM-DD), descricao, valor (number > 0), rateio[] com {id_categoria (UUID, via contaazul_list_categories), valor} (um `id_categoria` na raiz vira rateio de 100%) e condicao_pagamento.parcelas[] (cada: data_vencimento YYYY-MM-DD e detalhe_valor:{valor_bruto obrigatório; valor_liquido derivado se omitido}; descricao e conta_financeira da parcela, se omitidas, herdam as do lançamento; os aliases valor_composicao e composicao_valor são normalizados automaticamente). 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).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
No output schema declared.
No examples provided.
contaazul_person_delete ~57
Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_person_write_create ~262
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
| id | string | – | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_person_write_update ~262
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
| id | string | – | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_product_write ~79
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
No output schema declared.
No examples provided.
contaazul_receivable_create ~378
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_financial_accounts), data_competencia (YYYY-MM-DD), descricao, valor (number > 0), rateio[] com {id_categoria (UUID, via contaazul_list_categories), valor} (rateio_centro_custo[] opcional dentro de cada item; um `id_categoria` na raiz vira rateio de 100%), condicao_pagamento.parcelas[] (cada: data_vencimento YYYY-MM-DD; descricao e conta_financeira, se omitidas, herdam as do lançamento; nota opcional; 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). observacao é opcional. Retorna 202 + {protocolId,status} (processamento assíncrono).
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
No output schema declared.
No examples provided.
contaazul_sale_cancel ~56
Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| id | string | yes | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_sale_write_create ~255
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 próximo número livre da empresa. action=update (PUT /venda/{id}, substitui a venda) — passe `id` e os mesmos campos do create; `versao` (inteiro, controle de concorrência) é obrigatório na API e, se omitido, é lido da venda atual, assim como numero, id_cliente e situacao. situacao de escrita: EM_ANDAMENTO, APROVADO, FATURADO, CANCELADO (valores da busca como approved/invoiced são convertidos). [Flattened action: create] Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
| id | string | – | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_sale_write_update ~255
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 próximo número livre da empresa. action=update (PUT /venda/{id}, substitui a venda) — passe `id` e os mesmos campos do create; `versao` (inteiro, controle de concorrência) é obrigatório na API e, se omitido, é lido da venda atual, assim como numero, id_cliente e situacao. situacao de escrita: EM_ANDAMENTO, APROVADO, FATURADO, CANCELADO (valores da busca como approved/invoiced são convertidos). [Flattened action: update] Bulk support: accepts ids for batched execution.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
| id | string | – | – |
| ids | array | – | – |
No output schema declared.
No examples provided.
contaazul_service_write ~42
Cria um serviço. `data` é JSON com nome, valor, etc.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | – |
| data | string | yes | – |
No output schema declared.
No examples provided.
How do I install the Conta Azul MCP server?
Conta Azul MCP is a hosted endpoint at https://api.mcp.ai/contaazul, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.mcp.ai
claude mcp add --transport http douglac-contaazul-mcp 'https://api.mcp.ai/contaazul'
What is the Conta Azul MCP server?
Conta Azul MCP is listed in the public MCP registry as io.github.douglac/contaazul-mcp. Conta Azul ERP MCP, sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools. This page covers its hosted endpoint (https://api.mcp.ai/contaazul).
Is the Conta Azul MCP server safe to use?
Conta Azul MCP scores 69 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Conta Azul MCP server expose?
Conta Azul MCP exposes 58 tools: contaazul_list_accounts, contaazul_get_company, contaazul_list_people, contaazul_get_person, contaazul_person_write_create, and 53 more. Their descriptions and schemas cost roughly 8,519 tokens of context every time the server is loaded.
Does the Conta Azul MCP server require authentication?
No. We connected to Conta Azul MCP without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Conta Azul MCP server still maintained?
Conta Azul MCP is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the Conta Azul MCP server?
VerifyMCP ran 11 checks on Conta Azul MCP, covering TLS certificate, HSTS header, DNSSEC, Transport and 7 more. 2 items could not be completed, a gap on our side rather than a finding about Conta Azul MCP: Authorization and HTTPS. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.