Alpaca Trading API integration for Model Context Protocol (MCP)
Conta Azul is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http douglac-conta-azul-mcp https://api.mcp.ai/contaazul
# 2 — ask your agent for something these tools do
# contaazul_list_accounts, contaazul_get_company, contaazul_list_people and 49 more
Conta Azul costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http douglac-conta-azul-mcp https://api.mcp.ai/contaazulReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
52 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Lista as empresas Conta Azul vinculadas a este install (company_id, label).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account | string | no | — |
Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account | string | no | — |
Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| busca | string | no | — |
| tipo_perfil | string | no | — |
| ativo | boolean | no | — |
| account | string | no | — |
Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | no | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | no | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| busca | string | no | — |
| ativo | boolean | no | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data | string | yes | — |
| account | string | no | — |
Lista serviços cadastrados.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| busca | string | no | — |
| account | string | no | — |
Cria um serviço. data é JSON com nome, valor, etc.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data | string | yes | — |
| account | string | no | — |
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 (ex.: aprovado, em_andamento, faturado, cancelado, orcamento), termo_busca, ordenação por numero/cliente/data. Paginação: pagina + tamanho_pagina; a respost
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_inicio | string | no | — |
| data_fim | string | no | — |
| data_criacao_de | string | no | — |
| data_criacao_ate | string | no | — |
| data_alteracao_de | string | no | — |
| data_alteracao_ate | string | no | — |
| ids_clientes | array | no | — |
| ids_vendedores | array | no | — |
| ids_categorias | array | no | — |
| ids_produtos | array | no | — |
| numeros | array | no | — |
| situacoes | array | no | — |
| tipos | array | no | — |
| origens | array | no | — |
| termo_busca | string | no | — |
| campo_ordenado_ascendente | string | no | — |
| campo_ordenado_descendente | string | no | — |
| totais | string | no | — |
Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ids_venda | array | yes | — |
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| account | string | no | — |
Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | no | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | no | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_inicio | string | no | — |
| data_fim | string | no | — |
| cliente_id | string | no | — |
| busca_textual | string | no | — |
| account | string | no | — |
| cliente_ids | array | no | — |
Cria um contrato. data é o payload em JSON.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data | string | yes | — |
| account | string | no | — |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_vencimento_de | string | no | — |
| data_vencimento_ate | string | no | — |
| status | string | no | — |
| ids_clientes | string | no | — |
| account | string | no | — |
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, d
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data | string | yes | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_vencimento_de | string | no | — |
| data_vencimento_ate | string | no | — |
| status | string | no | — |
| account | string | no | — |
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 compo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data | string | yes | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id_evento | string | yes | — |
| account | string | no | — |
Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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"].
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| tipos | array | no | — |
| nome | string | no | — |
| apenas_ativo | boolean | no | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Lista categorias financeiras (DRE).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| tipo | string | no | — |
| account | string | no | — |
Lista centros de custo.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| account | string | no | — |
Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_emissao_inicio | string | no | — |
| data_emissao_fim | string | no | — |
| status | string | no | — |
| account | string | no | — |
Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_competencia_de | string | no | — |
| data_competencia_ate | string | no | — |
| id_cliente | string | no | — |
| numero_venda | string | no | — |
| status | string | no | — |
| tipo_negociacao | string | no | — |
| numero_nfse_inicial | number | no | — |
| numero_nfse_final | number | no | — |
| numero_rps_inicial | number | no | — |
| numero_rps_final | number | no | — |
| account | string | no | — |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Lista as baixas de uma parcela. id é o UUID da parcela. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Detalhe de uma baixa por id. id é o UUID da baixa. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| data | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. id é o UUID da baixa. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_inicio | string | no | — |
| data_fim | string | no | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data_inicio | string | no | — |
| data_fim | string | no | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| data_inicio | string | no | — |
| data_fim | string | no | — |
| account | string | no | — |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ids_parcelas | array | no | — |
| id_parcela | string | no | — |
| tipo | string | yes | — |
| conta_bancaria | string | no | — |
| descricao_fatura | string | no | — |
| data_vencimento | string | no | — |
| maximo_parcelas | number | no | — |
| desconto_antecipado | object | no | — |
| forcar | boolean | no | — |
| data | string | no | — |
| account | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Retorna o próximo número de contrato disponível.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account | string | no | — |
Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
Lista orçamentos (cliente, número, total, situação, versão). Paginado.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tamanho_pagina | number | no | — |
| pagina | number | no | — |
| account | string | no | — |
Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| account | string | no | — |
| ids | array | no | — |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| data | string | yes | — |
| account | string | no | — |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ids | array | yes | — |
| account | string | no | — |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Conta Azul or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.1.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Conta Azul can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.