Conta Azul MCP
Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.
| Endpoint | https://api.mcp.ai/contaazul (streamable-http) |
|---|---|
| Registry version | 0.1.0 |
| Now | 58 tools · grade D (56) · pin ts_9ea4b9f7396261a69a60da952983a019 · protocol 2025-06-18 |
| First / last listed | 2026-11-14 01:46 UTC / 2026-11-14 01:46 UTC |
| Grade over time | 2026-11-14: D (56), 58 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: contaazul_list_accounts contaazul_get_company contaazul_list_people contaazul_get_person contaazul_person_write_create contaazul_person_write_update contaazul_person_delete contaazul_list_products contaazul_product_write contaazul_list_services contaazul_service_write contaazul_list_sales contaazul_list_sale_items contaazul_get_sale contaazul_sale_write_create contaazul_sale_write_update contaazul_sale_cancel contaazul_list_contracts contaazul_contract_write contaazul_list_receivables contaazul_receivable_create contaazul_list_payables contaazul_payable_create contaazul_list_installments contaazul_get_installment contaazul_update_installment contaazul_list_financial_accounts contaazul_get_account_balance contaazul_list_categories contaazul_list_cost_centers contaazul_list_invoices_nfe contaazul_get_invoice_nfe contaazul_list_invoices_nfse contaazul_settle_installment contaazul_list_settlements contaazul_get_settlement contaazul_update_settlement contaazul_delete_settlement contaazul_list_transfers contaazul_get_initial_balance contaazul_list_changed_events contaazul_generate_charge contaazul_get_charge contaazul_cancel_charge contaazul_get_contract contaazul_contract_next_number contaazul_terminate_contract contaazul_delete_contract contaazul_list_budgets contaazul_get_budget contaazul_create_budget contaazul_delete_budgets show_version report_bug connect toolkit_info marketplace authenticate
contaazul_list_accounts | Lista as empresas Conta Azul vinculadas a este install (company_id, label). params: account |
contaazul_get_company | Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário). params: account |
contaazul_list_people | Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina (10, 20, 50 ou 100), pagina, busca (nome/documento), tipo_perfil, ativo. params: tamanho_pagina, pagina, busca, tipo_perfil, ativo, account |
contaazul_get_person | Detalhe de uma pessoa por id.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_person_write_create | 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 params: id, data*, account, ids |
contaazul_person_write_update | 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 params: id, data*, account, ids |
contaazul_person_delete | Remove uma pessoa por id. Operação destrutiva — confirme antes.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_list_products | Lista produtos cadastrados. Filtros: tamanho_pagina (10, 20, 50 ou 100), pagina, busca, ativo. params: tamanho_pagina, pagina, busca, ativo, account |
contaazul_product_write | 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. params: data*, account |
contaazul_list_services | Lista serviços cadastrados. Paginação: pagina + tamanho_pagina (10, 20, 50 ou 100). params: tamanho_pagina, pagina, busca, account |
contaazul_service_write | Cria um serviço. `data` é JSON com nome, valor, etc. params: data*, account |
contaazul_list_sales | 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, aprov params: 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 |
contaazul_list_sale_items | Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda. params: ids_venda*, tamanho_pagina, pagina, account |
contaazul_get_sale | Detalhe de uma venda por id.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_sale_write_create | 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 params: id, data*, account, ids |
contaazul_sale_write_update | 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 params: id, data*, account, ids |
contaazul_sale_cancel | Cancela uma venda. Operação destrutiva — confirme antes.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_list_contracts | 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. params: tamanho_pagina, pagina, data_inicio, data_fim, cliente_id, busca_textual, account, cliente_ids |
contaazul_contract_write | Cria um contrato. `data` é o payload em JSON. params: data*, account |
contaazul_list_receivables | 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; se omitidas, lista todas), 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- params: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate, status, data_pagamento_de, data_pagamento_ate, data_competencia_de, data_competencia_ate, ids_contas_financeiras, ids_categorias, ids_centros_de_custo, descricao, valor_de, valor_ate, ids_clientes, account |
contaazul_receivable_create | 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_categori params: data*, account |
contaazul_list_payables | 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; se omitidas, lista todas), 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) params: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate, status, data_pagamento_de, data_pagamento_ate, data_competencia_de, data_competencia_ate, ids_contas_financeiras, ids_categorias, ids_centros_de_custo, descricao, valor_de, valor_ate, account |
contaazul_payable_create | 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_cate params: data*, account |
contaazul_list_installments | 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. params: id_evento*, account |
contaazul_get_installment | 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. params: id*, account, ids |
contaazul_update_installment | 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: `rat params: id*, data*, account, ids |
contaazul_list_financial_accounts | 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"]. params: tamanho_pagina, pagina, tipos, nome, apenas_ativo, account |
contaazul_get_account_balance | 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. params: id*, account, ids |
contaazul_list_categories | Lista categorias financeiras (DRE). Paginação: pagina + tamanho_pagina (10, 20, 50 ou 100). params: tamanho_pagina, pagina, tipo, account |
contaazul_list_cost_centers | Lista centros de custo. Paginação: pagina + tamanho_pagina (10, 20, 50 ou 100). params: tamanho_pagina, pagina, account |
contaazul_list_invoices_nfe | 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 params: tamanho_pagina, pagina, data_inicial, data_final, documento_tomador, numero_nota, id_venda, data_emissao_inicio, data_emissao_fim, account |
contaazul_get_invoice_nfe | Detalhe de uma NF-e por id.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_list_invoices_nfse | 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_f params: 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 |
contaazul_settle_installment | 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: DINH params: id*, data*, account, ids |
contaazul_list_settlements | Lista as baixas de uma parcela. `id` é o UUID da parcela.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_get_settlement | Detalhe de uma baixa por id. `id` é o UUID da baixa.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_update_settlement | 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. params: id*, data*, account, ids |
contaazul_delete_settlement | Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_list_transfers | 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). params: tamanho_pagina, pagina, data_inicio, data_fim, account |
contaazul_get_initial_balance | 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. params: data_inicio, data_fim, account |
contaazul_list_changed_events | 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. params: tamanho_pagina, pagina, data_inicio, data_fim, account |
contaazul_generate_charge | 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 d params: ids_parcelas, id_parcela, tipo*, conta_bancaria, descricao_fatura, data_vencimento, maximo_parcelas, desconto_antecipado, forcar, data, account |
contaazul_get_charge | 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. params: id*, account, ids |
contaazul_cancel_charge | 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. params: id*, account, ids |
contaazul_get_contract | Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor).
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_contract_next_number | Retorna o próximo número de contrato disponível. params: account |
contaazul_terminate_contract | Encerra um contrato por id. Operação sensível, confirme antes.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_delete_contract | Remove um contrato por id. Operação destrutiva, confirme antes.
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_list_budgets | Lista orçamentos (cliente, número, total, situação, versão). Paginado: pagina + tamanho_pagina (10, 20, 50, 100, 200, 500 ou 1000). params: tamanho_pagina, pagina, account |
contaazul_get_budget | Detalhe de um orçamento por id (itens, cliente, composição de valor).
Bulk support: accepts ids for batched execution. params: id*, account, ids |
contaazul_create_budget | 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). params: data*, account |
contaazul_delete_budgets | 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). params: ids*, account |
show_version | Show the current MCP platform and adapter versions. params: none |
report_bug | Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. params: message*, context, conversation |
connect | Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs. params: none |
toolkit_info | Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes. params: none |
marketplace | 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. params: 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 |
authenticate | 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. params: token |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.