# Conta Azul MCP (io.github.douglac/contaazul-mcp): tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.github.douglac%2Fcontaazul-mcp/versions/latest)
- Connected to: https://api.mcp.ai/contaazul
- Repository: https://github.com/douglac/contaazul-mcp
- Scoring rules: v2
- Tools: 58
- Average: 28.4 / 100 (Rain)
- Near-identical pairs: 23

This page shows how Conta Azul MCP (io.github.douglac/contaazul-mcp)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

- Major: 58 tools. Above 40, models choose less accurately.
- Minor: 23 pairs with nearly the same description in all; the top 12 are shown.

## Tools

- `contaazul_contract_next_number`: 17 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_accounts`: 17 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_categories`: 17 / 100
  - Major: The description is too short (4 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, tipo, account.
  - Minor: String arguments with no constraint or example: tipo, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `contaazul_list_cost_centers`: 17 / 100
  - Major: The description is too short (4 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `contaazul_list_products`: 17 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, busca, ativo, account.
  - Minor: String arguments with no constraint or example: busca, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The meaning of the boolean argument ativo is unclear.
  - Minor: Says nothing about what it returns.
- `contaazul_list_services`: 17 / 100
  - Major: The description is too short (4 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, busca, account.
  - Minor: String arguments with no constraint or example: busca, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `contaazul_get_company`: 21 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_budgets`: 21 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `contaazul_list_people`: 21 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, busca, tipo_perfil, ativo, account.
  - Minor: String arguments with no constraint or example: busca, tipo_perfil, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The meaning of the boolean argument ativo is unclear.
  - Minor: Says nothing about what it returns.
- `contaazul_get_account_balance`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_budget`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_contract`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_initial_balance`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data_inicio, data_fim, account.
  - Minor: String arguments with no constraint or example: data_inicio, data_fim, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_get_installment`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_invoice_nfe`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_person`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_sale`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_list_changed_events`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_inicio, data_fim, account.
  - Minor: String arguments with no constraint or example: data_inicio, data_fim, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_contracts`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_inicio, data_fim, cliente_id, busca_textual, account, cliente_ids.
  - Minor: String arguments with no constraint or example: data_inicio, data_fim, cliente_id, busca_textual, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_invoices_nfse`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_competencia_de, data_competencia_ate, id_cliente, numero_venda, status, tipo_negociacao, numero_nfse_inicial, numero_nfse_final, numero_rps_inicial, numero_rps_final, account.
  - Minor: String arguments with no constraint or example: data_competencia_de, data_competencia_ate, id_cliente, numero_venda, status, tipo_negociacao, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_payables`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate, status, account.
  - Minor: String arguments with no constraint or example: data_vencimento_de, data_vencimento_ate, status, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_receivables`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate, status, ids_clientes, account.
  - Minor: String arguments with no constraint or example: data_vencimento_de, data_vencimento_ate, status, ids_clientes, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_sale_items`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: ids_venda, tamanho_pagina, pagina, account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: Says nothing about what it returns.
- `contaazul_list_transfers`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_inicio, data_fim, account.
  - Minor: String arguments with no constraint or example: data_inicio, data_fim, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_sale_cancel`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_terminate_contract`: 24 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_contract_write`: 25 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data, account.
  - Minor: String arguments with no constraint or example: data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_list_sales`: 25 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_inicio, data_fim, data_criacao_de, data_criacao_ate, data_alteracao_de, data_alteracao_ate, ids_clientes, ids_vendedores, ids_categorias, ids_produtos, numeros, situacoes, tipos, origens, termo_busca, campo_ordenado_ascendente, campo_ordenado_descendente, totais, cliente_id, status_venda, account, cliente_ids.
  - Minor: String arguments with no constraint or example: data_inicio, data_fim, data_criacao_de, data_criacao_ate, data_alteracao_de, data_alteracao_ate, termo_busca, cliente_id, status_venda, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_service_write`: 25 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data, account.
  - Minor: String arguments with no constraint or example: data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_delete_contract`: 27 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_person_delete`: 27 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_delete_settlement`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_get_settlement`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_list_financial_accounts`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, tipos, nome, apenas_ativo, account.
  - Minor: String arguments with no constraint or example: nome, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The meaning of the boolean argument apenas_ativo is unclear.
  - Minor: Says nothing about what it returns.
- `contaazul_list_invoices_nfe`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: tamanho_pagina, pagina, data_inicial, data_final, documento_tomador, numero_nota, id_venda, data_emissao_inicio, data_emissao_fim, account.
  - Minor: String arguments with no constraint or example: data_inicial, data_final, documento_tomador, numero_nota, id_venda, data_emissao_inicio, data_emissao_fim, account.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `contaazul_list_settlements`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `report_bug`: 30 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: message, context, conversation.
  - Minor: String arguments with no constraint or example: message.
  - Minor: Says nothing about what it returns.
- `contaazul_cancel_charge`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_create_budget`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data, account.
  - Minor: String arguments with no constraint or example: data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_delete_budgets`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: ids, account.
  - Minor: String arguments with no constraint or example: account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: ids. Name the tool or the place that returns it, or models look it up first.
- `contaazul_generate_charge`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: ids_parcelas, id_parcela, tipo, conta_bancaria, descricao_fatura, data_vencimento, maximo_parcelas, desconto_antecipado, desconto_antecipado.valor, desconto_antecipado.percentual, desconto_antecipado.dias_antes_vencer, forcar, data, account.
  - Minor: String arguments with no constraint or example: id_parcela, tipo, conta_bancaria, descricao_fatura, data_vencimento, data, account.
  - Minor: The meaning of the boolean argument forcar is unclear.
  - Minor: Says nothing about what it returns.
- `contaazul_get_charge`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, account, ids.
  - Minor: String arguments with no constraint or example: id, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `contaazul_list_installments`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id_evento, account.
  - Minor: String arguments with no constraint or example: id_evento, account.
  - Minor: Says nothing about what it returns.
- `contaazul_payable_create`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data, account.
  - Minor: String arguments with no constraint or example: data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_person_write_create`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_person_write_update`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_product_write`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data, account.
  - Minor: String arguments with no constraint or example: data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_receivable_create`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: data, account.
  - Minor: String arguments with no constraint or example: data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_sale_write_create`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_sale_write_update`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_settle_installment`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_update_installment`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
- `contaazul_update_settlement`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, data, account, ids.
  - Minor: String arguments with no constraint or example: id, data, account.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `authenticate`: 37 / 100
  - Major: Arguments without a description: token.
  - Minor: String arguments with no constraint or example: token.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `show_version`: 38 / 100
  - Major: The description only restates the name (8 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `toolkit_info`: 53 / 100
  - Major: Says nothing about when to use it, or when not to.
- `connect`: 64 / 100
- `marketplace`: 64 / 100
  - Major: Arguments without a description: action, query, mcp_id, limit, tier_slug, immediate, cancel_reason, cancel_comment, message, report_context, conversation, request_name, request_details, tool_id, arguments, prompt_slug, prompt_vars, prompt_category, prompt_tool, prompt_title, prompt_description, prompt_body, prompt_targets.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The meaning of the boolean argument immediate is unclear.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)
