Mcp Conta Azul

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Conta Azul — accounting, invoicing, customers, products

The publisher's own server: Azul CR — Costa Rica Local Business Data

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-conta-azul
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-conta-azul.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-conta-azul?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that connects an assistant to Conta Azul ERP for accounting, invoicing, customers, products, sales and financial summaries.

What you can do: List, create, update and delete customers and products in Conta Azul, plus list product and service categories and bank accounts. List, create, fetch and cancel sales, and list, create, update and delete services. Retrieve a financial summary and list accounts receivable. All actions run against the Conta Azul API using an OAuth2 bearer token.
When to use it: Useful when you work with Conta Azul as your ERP and want an assistant to look up or maintain customers, products, services, sales and receivables, or to pull a quick financial summary without opening the web interface.
Requirements: Runs locally via npx from the npm package @codespar/mcp-conta-azul, so Node.js is needed. Requires a Conta Azul OAuth2 access token supplied in the CONTA_AZUL_ACCESS_TOKEN environment variable, obtained by registering a developer app in the Conta Azul Developer Portal. Network access to the Conta Azul API. A sandbox is available for testing.

Before you install

The token in CONTA_AZUL_ACCESS_TOKEN grants access to real accounting data and should be kept secret. Several tools write to the ERP: creating, updating and deleting customers, products and services, creating sales and cancelling sales. Deletions and sale cancellations can affect financial records, so confirm before letting an assistant run them. The README also mentions a separate enterprise offering with payment routing, which is not part of this server.

Installation

In SourceWeft

Open Mcp Conta Azul in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-conta-azul

MCP server for Conta Azul — ERP, accounting, invoicing, and financial management

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

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

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

Claude Code

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{  "servers": {    "conta-azul": {      "command": "npx",      "args": ["-y", "@codespar/mcp-conta-azul"],      "env": {        "CONTA_AZUL_ACCESS_TOKEN": "your-token"      }    }  }}

{  "servers": {    "conta-azul": {      "command": "npx",      "args": ["-y", "@codespar/mcp-conta-azul"],      "env": {        "CONTA_AZUL_ACCESS_TOKEN": "your-token"      }    }  }}

Tools (20)

Tool	Purpose
`list_customers`	List customers in Conta Azul
`create_customer`	Create a customer in Conta Azul
`update_customer`	Update a customer in Conta Azul
`delete_customer`	Delete a customer in Conta Azul
`list_products`	List products in Conta Azul
`create_product`	Create a product in Conta Azul
`update_product`	Update a product in Conta Azul
`delete_product`	Delete a product in Conta Azul
`list_sales`	List sales in Conta Azul
`create_sale`	Create a sale in Conta Azul
`get_sale`	Get a sale by id in Conta Azul
`cancel_sale`	Cancel a sale in Conta Azul
`list_services`	List services in Conta Azul
`create_service`	Create a service in Conta Azul
`update_service`	Update a service in Conta Azul
`delete_service`	Delete a service in Conta Azul
`get_financial_summary`	Get financial summary from Conta Azul
`list_categories`	List product/service categories
`list_bank_accounts`	List bank accounts in Conta Azul
`list_accounts_receivable`	List accounts receivable (financial events to receive) in Conta Azul

Authentication

Conta Azul uses OAuth2 Bearer tokens for authentication.

Sandbox / Testing

Conta Azul provides a sandbox via the OAuth flow. Use sandbox credentials for testing.

Get your credentials

Go to Conta Azul Developer Portal
Register as a developer
Create an OAuth application and obtain an access token
Set the CONTA_AZUL_ACCESS_TOKEN environment variable

Environment Variables

Roadmap

v0.2 (planned)

list_bank_accounts — List registered bank accounts
create_bank_account — Register a new bank account
list_taxes — List tax entries
create_tax — Create a tax entry
get_cash_flow — Get cash flow summary report

v0.3 (planned)

reconciliation — Bank reconciliation tools
financial_reports — Generate financial summary reports

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/fiscal/conta-azul/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Azul integrations

Azul CR — Costa Rica Local Business Data

cr.azulOfficial publisher

Read-only MCP access to a Costa Rica local business directory: search businesses, jobs, events and specials, with optional keyed contact details.

Streamable HTTPWeb executable

Location & Lifestyle6 toolsOct 27, 2026

Conta Azul MCP

Published by GitHub account douglac

Connects an assistant to Conta Azul ERP over OAuth 2.0 to read and write sales, customers, products, finance and invoices.