Skip to main content
CO

Conta Azul

v0.2.1OAuth2

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

20 tools1 env varsπŸ‡§πŸ‡· Brazilstable on npm

What your agent can do

Conta Azul gives your agent 20 tools it calls directly β€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • list_customers β€” List customers in Conta Azul
  • create_customer β€” Create a customer in Conta Azul
  • update_customer β€” Update a customer in Conta Azul
Example call
// Your agent calls a tool directly β€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("list_customers", { /* ... */ });

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

Run `npx -y @codespar/mcp-conta-azul` and add the config block above to your MCP client β€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Conta Azul β€” MCP server Β· 20 tools | CodeSpar