Conta Azul MCP

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.

Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.

Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.

Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.

Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.

Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

Lista as empresas Conta Azul vinculadas a este install (company_id, label).

Lista orçamentos (cliente, número, total, situação, versão). Paginado.

Lista categorias financeiras (DRE).

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.

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.

Lista centros de custo.

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"].

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.

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).

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.

Lista contas a pagar (parcelas de despesa). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), status (PERDIDO, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO). O Conta Azul usa os MESMOS status de contas a receber (RECEBIDO aqui = pago) e o mesmo formato de item — parecido com list_receivables, mas são despesas.

Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.

Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.

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).

Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.

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; a resposta tr…

Lista serviços cadastrados.

Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.

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.

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 obrig…

Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

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 …

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 …

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.

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_venciment…

Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

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_ANDA…

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_ANDA…

Cria um serviço. `data` é JSON com nome, valor, etc.

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, C…

Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.

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 depoi…

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.

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…

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Show the current MCP platform and adapter versions.

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.