MCP Radar
Servidor MCP

Conta Azul MCP

io.github.douglac/contaazul-mcp
Negocio y operaciones Finanzas e inversión Pagos y fintech Público y accesible MCP 2025-11-25

Qué hace este MCP

Connects to Conta Azul ERP for managing customers, sales, budgets, contracts, financial accounts, receivables, invoices, settlements, and payment charges.

Capacidades

Herramientas

57 herramientas
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.
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'token': {'type': 'string'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
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.
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_contract_next_number
Retorna o próximo número de contrato disponível.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}}}
contaazul_contract_write
Cria um contrato. `data` é o payload em JSON.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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).
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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).
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_delete_contract
Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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.
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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 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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tipo'], 'properties': {'data': {'type': 'string'}, 'tipo': {'type': 'string'}, 'forcar': {'type': 'boolean'}, 'account': {'type': 'string'}, 'id_parcela': {'type': 'string'}, 'ids_parcelas': {'type': 'array', 'items': {'type': 'string'}}, 'conta_bancaria': {'type': 'string'}, 'data_vencimento': {'type': 'string'}, 'maximo_parcelas': {'type': 'number'}, 'descricao_fatura': {'type': 'string'}, 'desconto_antecipado': {'type': 'object', 'properties': {'valor': {'type': 'number'}, 'percentual': {'type': 'number'}, 'dias_antes_vencer': {'type': 'number'}}}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_get_budget
Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_get_company
Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'data_fim': {'type': 'string'}, 'data_inicio': {'type': 'string'}}}
contaazul_get_installment
Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_get_invoice_nfe
Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_get_person
Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_get_sale
Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_get_settlement
Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_list_accounts
Lista as empresas Conta Azul vinculadas a este install (company_id, label).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}}}
contaazul_list_budgets
Lista orçamentos (cliente, número, total, situação, versão). Paginado.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_list_categories
Lista categorias financeiras (DRE).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tipo': {'type': 'string'}, 'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'data_fim': {'type': 'string'}, 'data_inicio': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
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 (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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'data_fim': {'type': 'string'}, 'cliente_id': {'type': 'string'}, 'cliente_ids': {'type': 'array', 'items': {'type': 'string'}}, 'data_inicio': {'type': 'string'}, 'busca_textual': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_list_cost_centers
Lista centros de custo.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
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"].
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'nome': {'type': 'string'}, 'tipos': {'type': 'array', 'items': {'type': 'string'}}, 'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'apenas_ativo': {'type': 'boolean'}, 'tamanho_pagina': {'type': 'number'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id_evento'], 'properties': {'account': {'type': 'string'}, 'id_evento': {'type': 'string'}}}
contaazul_list_invoices_nfe
Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'status': {'type': 'string'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}, 'data_emissao_fim': {'type': 'string'}, 'data_emissao_inicio': {'type': 'string'}}}
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). 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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'status': {'type': 'string'}, 'account': {'type': 'string'}, 'id_cliente': {'type': 'string'}, 'numero_venda': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}, 'tipo_negociacao': {'type': 'string'}, 'numero_rps_final': {'type': 'number'}, 'numero_nfse_final': {'type': 'number'}, 'numero_rps_inicial': {'type': 'number'}, 'data_competencia_de': {'type': 'string'}, 'numero_nfse_inicial': {'type': 'number'}, 'data_competencia_ate': {'type': 'string'}}}
contaazul_list_payables
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).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'status': {'type': 'string'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}, 'data_vencimento_de': {'type': 'string'}, 'data_vencimento_ate': {'type': 'string'}}}
contaazul_list_people
Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ativo': {'type': 'boolean'}, 'busca': {'type': 'string'}, 'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'tipo_perfil': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_list_products
Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ativo': {'type': 'boolean'}, 'busca': {'type': 'string'}, 'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_list_receivables
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).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'status': {'type': 'string'}, 'account': {'type': 'string'}, 'ids_clientes': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}, 'data_vencimento_de': {'type': 'string'}, 'data_vencimento_ate': {'type': 'string'}}}
contaazul_list_sales
Lista vendas. Filtros: tamanho_pagina, pagina, data_inicio, data_fim (YYYY-MM-DD), cliente_id, status_venda. Bulk support: accepts cliente_ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'data_fim': {'type': 'string'}, 'cliente_id': {'type': 'string'}, 'cliente_ids': {'type': 'array', 'items': {'type': 'string'}}, 'data_inicio': {'type': 'string'}, 'status_venda': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_list_services
Lista serviços cadastrados.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'busca': {'type': 'string'}, 'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_list_settlements
Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pagina': {'type': 'number'}, 'account': {'type': 'string'}, 'data_fim': {'type': 'string'}, 'data_inicio': {'type': 'string'}, 'tamanho_pagina': {'type': 'number'}}}
contaazul_payable_create
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).
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'string'}, 'account': {'type': 'string'}}}
contaazul_person_delete
Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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":"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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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":"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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'string'}, 'account': {'type': 'string'}}}
contaazul_receivable_create
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).
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'string'}, 'account': {'type': 'string'}}}
contaazul_sale_cancel
Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
contaazul_sale_write_create
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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
contaazul_sale_write_update
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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
contaazul_service_write
Cria um serviço. `data` é JSON com nome, valor, etc.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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: 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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
contaazul_terminate_contract
Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.
Destructivo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'account': {'type': 'string'}}}
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: `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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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.
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'data'], 'properties': {'id': {'type': 'string'}, 'ids': {'type': 'array', 'items': {'type': 'string'}}, 'data': {'type': 'string'}, 'account': {'type': 'string'}}}
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. 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.
Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 10}, 'query': {'type': 'string', 'default': ''}, 'action': {'enum': ['search', 'describe', 'install', 'uninstall', 'subscribe', 'cancel', 'resume', 'report_bug', 'request_mcp', 'list_tools', 'invoke', 'search_prompts', 'get_prompt', 'publish_prompt'], 'type': 'string', 'default': 'search'}, 'mcp_id': {'type': 'string', 'default': ''}, 'message': {'type': 'string', 'default': ''}, 'tool_id': {'type': 'string', 'default': ''}, 'arguments': {'type': 'string', 'default': '{}'}, 'immediate': {'type': 'boolean', 'default': False}, 'tier_slug': {'type': 'string', 'default': ''}, 'prompt_body': {'type': 'string', 'default': ''}, 'prompt_slug': {'type': 'string', 'default': ''}, 'prompt_tool': {'type': 'string', 'default': ''}, 'prompt_vars': {'type': 'string', 'default': '{}'}, 'conversation': {'type': 'string', 'default': '[]'}, 'prompt_title': {'type': 'string', 'default': ''}, 'request_name': {'type': 'string', 'default': ''}, 'cancel_reason': {'enum': ['too_expensive', 'missing_features', 'switched_service', 'unused', 'customer_service', 'too_complex', 'low_quality', 'other'], 'type': 'string'}, 'cancel_comment': {'type': 'string', 'default': ''}, 'prompt_targets': {'type': 'array', 'items': {'enum': ['claude', 'chatgpt', 'cursor', 'lovable'], 'type': 'string'}, 'default': []}, 'report_context': {'type': 'string', 'default': ''}, 'prompt_category': {'type': 'string', 'default': ''}, 'request_details': {'type': 'string', 'default': ''}, 'prompt_description': {'type': 'string', 'default': ''}}}
report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'context': {'type': 'string', 'default': ''}, 'message': {'type': 'string'}, 'conversation': {'type': 'string', 'default': '[]'}}}
show_version
Show the current MCP platform and adapter versions.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
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.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Historial

Cambios recientes en herramientas

Añadido
authenticate
17 de September de 2026 a las 12:41
Añadido
marketplace
17 de September de 2026 a las 12:41
Añadido
toolkit_info
17 de September de 2026 a las 12:41
Añadido
connect
17 de September de 2026 a las 12:41
Añadido
report_bug
17 de September de 2026 a las 12:41
Añadido
show_version
17 de September de 2026 a las 12:41
Añadido
contaazul_delete_budgets
17 de September de 2026 a las 12:41
Añadido
contaazul_create_budget
17 de September de 2026 a las 12:41
Añadido
contaazul_get_budget
17 de September de 2026 a las 12:41
Añadido
contaazul_list_budgets
17 de September de 2026 a las 12:41
Añadido
contaazul_delete_contract
17 de September de 2026 a las 12:41
Añadido
contaazul_terminate_contract
17 de September de 2026 a las 12:41
Añadido
contaazul_contract_next_number
17 de September de 2026 a las 12:41
Añadido
contaazul_get_contract
17 de September de 2026 a las 12:41
Añadido
contaazul_cancel_charge
17 de September de 2026 a las 12:41
Añadido
contaazul_get_charge
17 de September de 2026 a las 12:41
Añadido
contaazul_generate_charge
17 de September de 2026 a las 12:41
Añadido
contaazul_list_changed_events
17 de September de 2026 a las 12:41
Añadido
contaazul_get_initial_balance
17 de September de 2026 a las 12:41
Añadido
contaazul_list_transfers
17 de September de 2026 a las 12:41
Añadido
contaazul_delete_settlement
17 de September de 2026 a las 12:41
Añadido
contaazul_update_settlement
17 de September de 2026 a las 12:41
Añadido
contaazul_get_settlement
17 de September de 2026 a las 12:41
Añadido
contaazul_list_settlements
17 de September de 2026 a las 12:41
Añadido
contaazul_settle_installment
17 de September de 2026 a las 12:41
Añadido
contaazul_list_invoices_nfse
17 de September de 2026 a las 12:41
Añadido
contaazul_get_invoice_nfe
17 de September de 2026 a las 12:41
Añadido
contaazul_list_invoices_nfe
17 de September de 2026 a las 12:41
Añadido
contaazul_list_cost_centers
17 de September de 2026 a las 12:41
Añadido
contaazul_list_categories
17 de September de 2026 a las 12:41
Descubrir

Servidores MCP similares

Lovie Company Formation

co.lovie/company-formation

Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…

Conta Simples

io.github.mcp-dir/contasimples-mcp

Manages Conta Simples business banking, balances, statements, invoices, corporate cards, users, categories, suppliers, and cost c…

mercoa

io.usefulapi/mercoa

Manages Mercoa accounts payable and receivable entities, invoices, payment methods, transactions, metrics, and audit events.

Stratalize Finance

com.stratalize/finance

Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…

Red by Big Red Cloud

io.github.BigRedCloud/red-mcp-server

Connects to Big Red Cloud accounting for customers, suppliers, products, invoices, purchases, payments, receipts, journals, quote…

AgentLot Marketplace

io.agentlot/marketplace

Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.

GestãoClick

io.github.mcp-dir/gestaoclick-mcp

Connects to the GestãoClick ERP to manage customers, suppliers, products, sales, service orders, budgets, and financial records.

BeeL

es.beel/mcp

Provides Spanish company administration and VeriFactu-compliant invoicing, including customers, products, invoice issuance, corre…