Conta Azul MCP

Name: Conta Azul MCP
Author: douglac

by douglacversion 0.1.0i★ –iRuns in the cloud

Registry nameio.github.douglac/contaazul-mcp

Install

Overview

Description from the maker (original English)

Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Accounting, finance & tax

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
The registry lists no key to fill in.

You need

Runs in the cloudNothing to install; it connects over the internet

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://api.mcp.ai/contaazul

Run this in your terminal

claude mcp add --transport http contaazul https://api.mcp.ai/contaazul

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "contaazul": {
      "url": "https://api.mcp.ai/contaazul"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "contaazul": {
      "type": "http",
      "url": "https://api.mcp.ai/contaazul"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://api.mcp.ai/contaazul

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account douglac, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Accounting, finance & taxi

More stars than 0% of the other 2902 servers in this category
Published to the registry more recently than 9% of the other 2902 servers in this category
Basic checks equal to or better than 100% of the other 2902 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Conta Azul MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.0) reached the registry 5 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Finance Toolkit, SolidInvoice, Korea Tax Calculator

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Finance Toolkit

by JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

Computer or cloud★ 5,496MITUpdated yesterday

Install

SolidInvoice

by SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

Runs in the cloud★ 981MITUpdated 8 days ago

Install

Korea Tax Calculator

by UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

Runs on your computer★ 97MITUpdated yesterday

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Conta Azul MCP

ERP financeiro Conta Azul para Claude, Cursor e agentes de IA

Conecte sua conta Conta Azul ao seu agente de IA. Gerencie clientes e fornecedores, produtos, serviços, vendas, contratos, contas a pagar e receber, parcelas, quitações e NF-e em linguagem natural. Login via OAuth da própria Conta Azul, em 30 segundos — sem digitar token, sem configurar nada.

🏢 ERP completo — pessoas, produtos, vendas, contratos, financeiro e NF-e em um só lugar
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
✍️ Lê e escreve — a IA consulta dados e também cria/edita cadastros, vendas, contas e quitações (sempre quando você pede)
📊 52 ferramentas cobrindo a API v2 da Conta Azul
🔑 OAuth 2.0 da Conta Azul — a plataforma fornece a aplicação OAuth, você só clica em Autorizar
🛡️ LGPD-compliant — consentimento explícito, retenção mínima, você no controle

English version · Documentação completa · Skills do Claude Code

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado na sua conta):

➕ Abrir no Claude e conectar

Esse link abre o modal "Adicionar conector personalizado" já com nome (Conta Azul MCP) e URL (https://api.mcp.ai/contaazul) pré-preenchidos. Clique Adicionar, faça login via magic-link na primeira chamada, autorize sua empresa Conta Azul.

Manual (se o deeplink não abrir): vá em claude.ai/customize/connectors → clique + → Adicionar conector personalizado → cole:

Nome: Conta Azul MCP
URL: https://api.mcp.ai/contaazul

Cursor

➕ Instalar Conta Azul MCP no Cursor

VS Code (Copilot Chat)

➕ Instalar Conta Azul MCP no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Conta Azul MCP funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre a mesma:

https://api.mcp.ai/contaazul

Veja INSTALL.md pra exemplos de configuração por cliente.

Instruções detalhadas: INSTALL.md — config manual em arquivo (claude_desktop_config.json, .cursor/mcp.json, .vscode/mcp.json), fluxo agent-auth pra clientes sem OAuth, troubleshooting, e instruções pra IA te ajudar a instalar.

Prompt pronto pra agents autônomos (OpenClaw, Hermes, etc.)

Alguns agents autônomos tratam MCP como processo local (stdio/npx) ou param na etapa de "registrar no config" sem nunca chamar as tools. Cole o prompt abaixo pra forçar o consumo correto como MCP remoto HTTP e rodar o fluxo de autenticação de ponta a ponta:

📋 Copiar prompt (PT-BR)

Use o Conta Azul MCP (ERP financeiro brasileiro, API v2 da Conta Azul) como um servidor MCP externo remoto via HTTP. Não trate esse MCP como local, não use stdio, não execute npx, node, subprocesso para "subir" servidor, e não assuma que apenas registrar a URL em config é suficiente. O endpoint é https://api.mcp.ai/contaazul e deve ser consumido por MCP remoto via HTTP/streamable-http. A prioridade é: (1) se o ambiente tiver suporte nativo a cliente MCP remoto HTTP, use-o; (2) se não tiver, procure um cliente MCP HTTP externo já disponível no próprio ambiente/servidor e use-o para conectar ao endpoint e chamar as tools; (3) só declare limitação depois de tentar ambos os caminhos. O objetivo é realmente consumir o MCP remoto, não apenas cadastrá-lo. Primeiro, se o ambiente usar registro/config de MCP, registre o servidor com nome como contaazul-mcp, URL https://api.mcp.ai/contaazul e transporte streamable-http; em seguida, teste conectividade real ao endpoint remoto. Antes de qualquer autenticação, liste as ferramentas disponíveis no servidor remoto; como o Conta Azul MCP é soft-gate, a descoberta inicial (mesmo deslogado) deve retornar TODAS as ferramentas do ERP — contaazul_list_accounts, contaazul_get_company, contaazul_list_people, contaazul_list_sales, contaazul_list_receivables, contaazul_list_payables, contaazul_list_invoices_nfe e demais contaazul_* — além de show_version, report_bug, connect e authenticate. Se a listagem funcionar, prossiga obrigatoriamente com o fluxo. O fluxo correto é: 1. chamar a tool authenticate sem argumentos (ou chamar qualquer tool contaazul_* deslogado, que retornará o link de autenticação); 2. se retornar um link de login, mostrar esse link ao usuário e instruí-lo a abrir, autenticar no mcp.ai e enviar o token retornado; 3. quando o usuário enviar o token, chamar authenticate novamente com { "token": "<jwt_enviado_pelo_usuario>" }; 4. após autenticação confirmada, chamar connect; 5. se connect retornar um link de autorização da Conta Azul (OAuth 2.0), mostrar ao usuário para abrir, logar na conta Conta Azul dele e autorizar o acesso à empresa; 6. depois da conexão, usar as tools de consulta contaazul_list_accounts, contaazul_get_company, contaazul_list_sales, contaazul_list_people, contaazul_list_receivables, contaazul_list_payables e contaazul_list_invoices_nfe para ler os dados do ERP. O Conta Azul MCP também tem ferramentas de escrita (criar/atualizar pessoas, produtos, vendas, contratos, contas a pagar/receber, quitar parcelas) — só use escrita quando o usuário pedir explicitamente, e confirme antes de operações destrutivas (cancelar venda/contrato, excluir pessoa). O assistente deve ser operacional: não parar na etapa de config se houver um modo de realmente chamar tools no ambiente; não pedir instalação de SDK sem necessidade; não dizer que "não é possível" sem antes verificar suporte nativo MCP remoto e, na falta dele, a existência de cliente MCP HTTP externo já presente no ambiente. Se o ambiente exigir reinício, reload de serviço ou reaplicação de configuração para usar o MCP, avise o usuário antes, com mensagem clara como: "Vou reiniciar para aplicar a configuração do Conta Azul MCP — volto em instantes." Depois confirme que voltou. Se não precisar reiniciar, não mencione reinício. Ao receber um link de autenticação de authenticate, responda objetivamente com algo como: "Abra este link, faça login no mcp.ai e me envie o token que aparecer: <link>". Em resumo: trate o Conta Azul MCP como MCP remoto HTTP, tente conexão real, liste tools, execute authenticate, peça o token ao usuário, execute authenticate com token, depois execute connect, peça a autorização OAuth na Conta Azul e então use as tools contaazul_* para consultar (e, quando o usuário pedir, gerenciar) os dados do ERP.

Pergunte sobre o seu negócio

Depois de autorizar sua empresa, faça perguntas e dê comandos como:

Liste as 20 últimas vendas e o total faturado nos últimos 30 dias

Quais contas a pagar vencem essa semana? Quais contas a receber estão vencidas hoje? Cadastra o cliente João Silva (CPF 123.456.789-00, e-mail joao@ex.com) Cria um produto "Setup Inicial" com valor de venda R$ 499 Registra uma venda do produto Mensalidade Premium para o cliente X Resume meu fluxo de caixa do mês (entradas vs saídas) Quita a parcela de R$ 250 que venceu hoje na conta do Itaú Lista as NF-e emitidas em maio

✍️ Lê e escreve: além de consultar, a IA pode criar e alterar dados na sua Conta Azul — cadastros, vendas, contratos, contas a pagar/receber e quitações. As escritas só acontecem quando você pede. Recomendamos revisar a ação proposta antes de confirmar (especialmente cancelamentos e exclusões, que são destrutivos).

52 ferramentas disponíveis

Cobrem a API v2 da Conta Azul, organizadas por módulo. Detalhe de cada uma em docs/ferramentas.md.

Empresa & contas

Tool	Descrição
`contaazul_list_accounts`	Lista as empresas Conta Azul vinculadas
`contaazul_get_company`	Dados da empresa ativa (CNPJ, razão social, regime tributário)

Pessoas (clientes / fornecedores / vendedores / transportadores)

Tool	Descrição
`contaazul_list_people`	Lista pessoas (filtros: busca, tipo, ativo)
`contaazul_get_person`	Detalhe de uma ou mais pessoas por id
`contaazul_person_write_create`	Cria uma pessoa
`contaazul_person_write_update`	Atualiza uma pessoa (só os campos enviados)
`contaazul_person_delete`	Remove pessoas (destrutivo)

Produtos & serviços

Tool	Descrição
`contaazul_list_products`	Lista produtos cadastrados
`contaazul_product_write`	Cria um produto
`contaazul_list_services`	Lista serviços cadastrados
`contaazul_service_write`	Cria um serviço

Vendas & orçamentos

Tool	Descrição
`contaazul_list_sales`	Lista vendas (filtros: cliente, vendedor, situação, categoria, produto, número, datas, texto livre)
`contaazul_list_sale_items`	Itens (produtos/serviços, quantidade, valor) de até 50 vendas
`contaazul_get_sale`	Detalhe de uma ou mais vendas por id
`contaazul_sale_write_create`	Cria uma venda
`contaazul_sale_write_update`	Atualiza uma venda
`contaazul_sale_cancel`	Cancela vendas (destrutivo)
`contaazul_list_budgets`	Lista orçamentos
`contaazul_get_budget`	Detalhe de um ou mais orçamentos por id
`contaazul_create_budget`	Cria um orçamento
`contaazul_delete_budgets`	Exclui orçamentos (destrutivo)

Contratos

Tool	Descrição
`contaazul_list_contracts`	Lista contratos por período
`contaazul_get_contract`	Detalhe de um ou mais contratos por id
`contaazul_contract_next_number`	Próximo número de contrato disponível
`contaazul_contract_write`	Cria um contrato
`contaazul_terminate_contract`	Encerra contratos
`contaazul_delete_contract`	Remove contratos (destrutivo)

Financeiro: contas a receber e a pagar

Tool	Descrição
`contaazul_list_receivables`	Lista contas a receber (filtros: vencimento, status)
`contaazul_receivable_create`	Cria uma conta a receber
`contaazul_list_payables`	Lista contas a pagar (filtros: vencimento, status)
`contaazul_payable_create`	Cria uma conta a pagar
`contaazul_list_changed_events`	Eventos financeiros alterados num período (sync incremental)

Financeiro: parcelas e baixas

Tool	Descrição
`contaazul_list_installments`	Parcelas de um evento financeiro
`contaazul_get_installment`	Detalhe de uma ou mais parcelas por id
`contaazul_update_installment`	Atualiza campos de uma parcela
`contaazul_settle_installment`	Registra a baixa (recebimento/pagamento) de uma parcela
`contaazul_list_settlements`	Lista as baixas de uma parcela
`contaazul_get_settlement`	Detalhe de uma baixa por id
`contaazul_update_settlement`	Atualiza uma baixa
`contaazul_delete_settlement`	Estorna uma baixa (destrutivo)

Cobranças

Tool	Descrição
`contaazul_generate_charge`	Gera boleto, Pix ou link de pagamento para parcelas
`contaazul_get_charge`	Detalhe de uma cobrança emitida
`contaazul_cancel_charge`	Cancela uma cobrança emitida

Contas financeiras, categorias e centros de custo

Tool	Descrição
`contaazul_list_financial_accounts`	Lista contas financeiras (banco, caixa, cartão)
`contaazul_get_account_balance`	Saldo atual de uma conta financeira

| contaazul_get_initial_balance | Saldos iniciais das contas por per

Only the beginning is shown; read the rest in the repo

Conta Azul MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Accounting, finance & taxi

Common questions

Alternatives

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README from the maker

Conta Azul MCP

ERP financeiro Conta Azul para Claude, Cursor e agentes de IA

Instalar em 1 clique

Claude (Web e Desktop)

Cursor

VS Code (Copilot Chat)

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Prompt pronto pra agents autônomos (OpenClaw, Hermes, etc.)

Pergunte sobre o seu negócio

52 ferramentas disponíveis

Empresa & contas

Pessoas (clientes / fornecedores / vendedores / transportadores)

Produtos & serviços

Vendas & orçamentos

Contratos

Financeiro: contas a receber e a pagar

Financeiro: parcelas e baixas

Cobranças

Contas financeiras, categorias e centros de custo