{"_id":"@codespar/mcp-midaz","name":"@codespar/mcp-midaz","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-midaz","version":"0.1.0","description":"MCP server for Midaz by Lerian — self-hosted open-source multi-currency double-entry ledger: accounts, balances, transactions","type":"module","main":"./dist/index.js","bin":{"mcp-midaz":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","midaz","lerian","ledger","double-entry","accounting","multi-currency","open-source","self-hosted"],"mcpName":"io.github.codespar/mcp-midaz","_id":"@codespar/mcp-midaz@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-ufBAxrv4rfeIJIvagcTGZGvib7ZyAXPZfojEtKdbCAY/xmSCXrvAm3TXFhBn5fGXynumOVVLAbMZDoyB+NTqAQ==","shasum":"cdb217c167cb3649668ff58647d848f56da68b92","tarball":"https://registry.npmjs.org/@codespar/mcp-midaz/-/mcp-midaz-0.1.0.tgz","fileCount":4,"unpackedSize":16519,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEE4mdx7CuSYUipsMxtQks5pTI+4td52CrDvgcZJdhCUAiBwXuU+kfgHkjbGcIsR0qyZJsLHYgUnZzL/Ohek3ShgGg=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-midaz_0.1.0_1783129561278_0.8323417120518022"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:46:01.142Z","0.1.0":"2026-07-04T01:46:01.423Z","modified":"2026-07-04T01:46:01.633Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Midaz by Lerian — self-hosted open-source multi-currency double-entry ledger: accounts, balances, transactions","keywords":["mcp","midaz","lerian","ledger","double-entry","accounting","multi-currency","open-source","self-hosted"],"license":"MIT","readme":"# @codespar/mcp-midaz\n\n> MCP server for **Midaz** by [Lerian](https://lerian.studio) — 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**.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-midaz)](https://www.npmjs.com/package/@codespar/mcp-midaz)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Self-hosted model\n\nMidaz is **not a SaaS** — it runs in your infrastructure ([github.com/LerianStudio/midaz](https://github.com/LerianStudio/midaz)). This server points at your deployment:\n\n- `MIDAZ_BASE_URL` → your onboarding service (organizations / ledgers / accounts)\n- `MIDAZ_TRANSACTION_URL` → your transaction service (defaults to `MIDAZ_BASE_URL` when both sit behind one gateway)\n- `MIDAZ_API_KEY` → only if your deployment enforces auth\n\nMidaz hierarchy: **Organization → Ledger → Account → Transaction**. Tools take `organization_id` + `ledger_id` explicitly, so one connection can operate across ledgers.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"midaz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-midaz\"],\n      \"env\": {\n        \"MIDAZ_BASE_URL\": \"https://midaz.your-company.internal\",\n        \"MIDAZ_API_KEY\": \"your-token-if-any\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add midaz -- npx @codespar/mcp-midaz\n```\n\n## Tools (5)\n\n| Tool | What it does |\n|---|---|\n| `create_account` | Create an account in a ledger (`POST .../accounts`) |\n| `list_accounts` | List a ledger's accounts, paginated |\n| `get_balance` | Read available / on-hold balances per asset |\n| `create_transaction` | Post a balanced double-entry transaction (`POST .../transactions/json`) |\n| `get_transaction` | Fetch a transaction with its operations |\n\n## Example\n\n> \"Move R$ 1.250,00 from the treasury account to @vendor-acme and show both balances.\"\n\nThe 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.\n\n## Authentication\n\nYour 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).\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent-driven ledger operations on Midaz? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds a policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT (this server). Midaz itself is Apache-2.0 by Lerian.\n","readmeFilename":"README.md","_rev":"1-764769bababa7eb63437e1e8acbaf20a"}