Skip to main content
M

Midaz

@codespar/mcp-midaz · v0.1.0

🌐 GlobalBankingAuth · API Keybeta5 tools3 env vars

Lerian's open-source multi-currency double-entry ledger. Self-hosted: the connection stores your deployment endpoint and agents post entries via codespar_ledger.

Get started · freeView docs

MIT · runs locally or through the CodeSpar runtime

Limitations

  • The npm package ships no server.json manifest.
Package
@codespar/mcp-midaz
Version
0.1.0
npm dist-tag
latest
Category
Banking
Auth
API Key
Country
🌐 Global
License
MIT
Transport
stdio

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, or through the hosted runtime.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables3 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 5 tools. Try create_account first.
terminal
# Claude Code claude mcp add midaz -e MIDAZ_API_KEY=… -e MIDAZ_BASE_URL=… -e MIDAZ_TRANSACTION_URL=… -- npx -y @codespar/mcp-midaz@0.1.0 # then: /mcp to confirm the server is connected
Environment variables3 variables
MIDAZ_API_KEYBearer token when your deployment enforces authoptionalsecret
MIDAZ_BASE_URLBase URL of your self-hosted Midaz onboarding servicerequired
MIDAZ_TRANSACTION_URLBase URL of the Midaz transaction service. Defaults to MIDAZ_BASE_URL.optional

Names read from the package code (@codespar/mcp-midaz@0.1.0). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials. On the CodeSpar runtime the credential you connect is stored encrypted (AES-256-GCM, key derived per organization), and the runtime adds it to the provider call itself; the agent never receives it.

First call democreate_account

"Create an account in a ledger"

tools/callcreate_accountresult returned

Tools

What your agent can call.

5 tools, as the package's tools/list returns them.

create_account

Create an account in a ledger (POST /v1/organizations/{org}/ledgers/{ledger}/accounts). Accounts hold balances per asset code (e.g. BRL, USD, USDC).

list_accounts

List a ledger's accounts (GET /v1/organizations/{org}/ledgers/{ledger}/accounts). Paginated via limit/page.

get_balance

Read an account's balances (GET /v1/organizations/{org}/ledgers/{ledger}/accounts/{account}/balances). Returns available and on-hold amounts per asset.

create_transaction

Post a balanced double-entry transaction (POST /v1/organizations/{org}/ledgers/{ledger}/transactions/json). The send block debits source accounts and credits distribute targets; amounts must balance. Accounts are referenced by id or @alias.

get_transaction

Fetch a transaction with its operations (GET /v1/organizations/{org}/ledgers/{ledger}/transactions/{id}).

Names and descriptions come from the package's tools/list (@codespar/mcp-midaz@0.1.0). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

Through the CodeSpar runtime, codespar_discover finds this server's tools, and a tools/call runs with the credential connected in your project, a test key included.

hostedhttps://connect.codespar.dev/mcp15 meta-tools

Protocol

Any MCP client

stdio

Questions

Before you install.

How do I install the Midaz MCP server?

Run npx -y @codespar/mcp-midaz@0.1.0 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? Add the CodeSpar endpoint with a test key and connect Midaz in your project; codespar_discover finds its tools.

What can my agent do with Midaz?

Midaz exposes 5 tools for banking. Your agent calls them directly; the full list is above.

How does Midaz authenticate, and how are credentials stored?

Midaz uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables. On the CodeSpar runtime the credential you connect is stored encrypted for your organization, and the runtime adds it to each provider call, so the agent never handles it.

How does Midaz handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.1.0, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Midaz open source? How do I report a bug?

Yes. Midaz is MIT-licensed and published on npm as @codespar/mcp-midaz, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

On the CodeSpar runtime, the credential you connect stays encrypted for your organization and the runtime adds it to each call. You just call the tool.

Start in seconds demo
Create an account and copy a test key.
Add the hosted endpoint to your client with the config above.
Connect Midaz in your project and ask your agent for the first call.
Midaz — MCP server · 5 tools | CodeSpar