Conta Azul

v0.2.0OAuth2

Cloud accounting with invoicing, bank reconciliation, and cash flow management. Your agent automates bookkeeping for Brazilian SMBs.

20 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-conta-azul

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "conta-azul": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-conta-azul"
      ],
      "env": {
        "CONTA_AZUL_ACCESS_TOKEN": "<your_conta_azul_access_token>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try list_customers first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

CONTA_AZUL_ACCESS_TOKEN

requiredsecret

API key for conta-azul

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READlist_customers

List customers in Conta Azul

WRITEcreate_customer

Create a customer in Conta Azul

WRITEupdate_customer

Update a customer in Conta Azul

DELETEdelete_customer

Delete a customer in Conta Azul

READlist_products

List products in Conta Azul

WRITEcreate_product

Create a product in Conta Azul

WRITEupdate_product

Update a product in Conta Azul

DELETEdelete_product

Delete a product in Conta Azul

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.