Mcp Midaz

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

MCP server for Midaz by Lerian — self-hosted double-entry ledger: accounts, balances, transactions

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

A local MCP server that lets an assistant create accounts, read balances and post balanced double-entry transactions on your own self-hosted Midaz ledger.

What you can do
Create and list accounts within a ledger, with pagination for listings. Read available and on-hold balances per asset for an account. Post balanced double-entry transactions and fetch a transaction together with its operations. Tools take organization and ledger identifiers explicitly, so one connection can work across multiple ledgers.
When to use it
Use it when you run a self-hosted Midaz ledger and want an assistant to look up balances or record balanced transfers between accounts, for example moving funds from a treasury account to a vendor account and confirming both balances.
Requirements
Runs locally via npx from the npm package, on desktop only. Requires MIDAZ_BASE_URL pointing at your onboarding service; MIDAZ_TRANSACTION_URL optionally points at the transaction service and defaults to the base URL. MIDAZ_API_KEY is needed only if your deployment enforces auth. Network access to your Midaz deployment is required.
Before you install
The server can create accounts and post transactions that move money in your ledger, so review write actions before approving them. MIDAZ_API_KEY is a secret sent as a Bearer token; without it requests go unauthenticated, which is only safe on isolated internal networks. All data goes to your own Midaz deployment, not a third party.

Installation

In SourceWeft

  1. Open Mcp Midaz in the dashboard and add it to a workspace.
  2. 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-midaz

MCP server for Midaz by Lerian — the open-source, multi-currency, multi-asset double-entry ledger. Your agent creates accounts, reads balances, and posts balanced transactions against your own Midaz deployment.

[npm] [License: MIT]

Self-hosted model

Midaz is not a SaaS — it runs in your infrastructure (github.com/LerianStudio/midaz). This server points at your deployment:

  • MIDAZ_BASE_URL → your onboarding service (organizations / ledgers / accounts)
  • MIDAZ_TRANSACTION_URL → your transaction service (defaults to MIDAZ_BASE_URL when both sit behind one gateway)
  • MIDAZ_API_KEY → only if your deployment enforces auth

Midaz hierarchy: Organization → Ledger → Account → Transaction. Tools take organization_id + ledger_id explicitly, so one connection can operate across ledgers.

Quick Start

Claude Desktop

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

json
{  "mcpServers": {    "midaz": {      "command": "npx",      "args": ["-y", "@codespar/mcp-midaz"],      "env": {        "MIDAZ_BASE_URL": "https://midaz.your-company.internal",        "MIDAZ_API_KEY": "your-token-if-any"      }    }  }}

Claude Code

bash
claude mcp add midaz -- npx @codespar/mcp-midaz

Tools (5)

ToolWhat it does
create_accountCreate an account in a ledger (POST .../accounts)
list_accountsList a ledger's accounts, paginated
get_balanceRead available / on-hold balances per asset
create_transactionPost a balanced double-entry transaction (POST .../transactions/json)
get_transactionFetch a transaction with its operations

Example

"Move R$ 1.250,00 from the treasury account to @vendor-acme and show both balances."

The agent calls create_transaction with a send block debiting treasury and crediting @vendor-acme (amounts must balance — Midaz rejects lopsided entries), then get_balance on each account.

Authentication

Your deployment decides: when MIDAZ_API_KEY is set it is sent as a Bearer token; otherwise requests are unauthenticated (typical for network-isolated internal deployments).

Enterprise

Need governance, budget limits, and audit trails for agent-driven ledger operations on Midaz? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT (this server). Midaz itself is Apache-2.0 by Lerian.

Source: packages/banking/midaz/README.md at commit d0a519a

Tools

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

Version history

1
  1. v0.1.0LatestSep 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