LawPracticeZA MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LawPracticeZA MCP List unbilled fees for matter 12345"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LawPracticeZA MCP
MCP (Model Context Protocol) server for LawPracticeZA, South African legal practice software. It exposes curated tools for clients, matters, WIP fees, billing, and accounting — not a 1:1 dump of every undocumented object/method.
The stdio server registers curated read tools (APP-132), write tools for clients/matters/transfers/WIP (APP-137), and a bootstrap lpza_ping helper. Live LawPracticeZA calls require LPZA_DATABASE, LPZA_LOGIN_CODE, and LPZA_PASSWORD; without them, tools return a configuration error. CI uses fixture-backed mock HTTP only.
License: GPL-3.0-only
Requirements
Node.js 20 or later
npm
Related MCP server: lawruler-mcp
Run
npm install
npx tsx src/index.tsOr npm start. The server waits on stdin. Logs go to stderr; stdout is the MCP JSON-RPC channel.
Exercise it without a host:
npx @modelcontextprotocol/inspector npx tsx src/index.tsEnvironment variables
Variable | Required | Description |
| yes (for live tools) | LawPracticeZA firm database name |
| yes (for live tools) | API login code |
| yes (for live tools) | API password |
| no | Defaults to |
Copy .env.example to .env for local values. Never commit credentials.
Cloud Agent / CI secrets
For live verification in Cursor Cloud Agents, add these as environment secrets (not committed files):
Secret name | Value |
| MS&B Inc firm code / database name |
| Bookkeeper API user login code |
| API password |
Once secrets are configured, run:
npm run verify:loginThe script calls access.login and access.status and prints only non-sensitive fields (database name, login name). It exits non-zero when credentials are missing or login fails.
MCP tools
Bootstrap
Tool | Description |
| Confirms the stdio process is alive; does not call LawPracticeZA |
Session / lookups
Tool | LawPracticeZA API | Notes |
|
| Session logged-in state and login identity |
|
| Firm name, VAT flag, contact details |
|
| Optional |
|
| Fee earners |
|
| Posting codes (products) |
Clients / matters (read)
Tool | LawPracticeZA API | Notes |
|
| |
|
| Requires |
|
| |
|
| Optional |
Accounting reads
Tool | LawPracticeZA API | Notes |
|
| Business, trust, investment balances |
|
| Optional |
|
| Business ledger entries (invoice level) |
Clients / matters / WIP (write)
Tool | API | Notes |
|
| Requires |
|
| Creates a matter under a client |
|
| Fetch-merge-full-update (not partial) |
|
| Buyer/seller matters for conveyancing |
|
| WIP draft fees for a matter |
|
| Caller supplies |
|
| Requires |
Errors
Read tools return JSON with isError: true when credentials are missing (credentials_missing) or LawPracticeZA returns HTTP 403 (LpzaAuthError), 406 (LpzaValidationError), or 500 (LpzaServerError). Write tools refuse without credentials or when confirm: true is missing on destructive actions.
Planned later: billing with confirm gates and lpza_api_call escape hatch.
Development
npm run typecheck
npm test
npm run verify:login # requires LPZA_* env; see READMECI runs typecheck and tests on push and pull request to main.
HTTP client (src/lpza/)
Module | Role |
|
|
|
|
| Typed errors for HTTP 200 / 403 / 406 / 500 |
| Schema types: |
Fixture tests in tests/lpza-client.test.ts, tests/read-tools.test.ts, and tests/write-tools.test.ts mock HTTP — no live credentials required.
Limits
Without env credentials, read and write tools refuse with a configuration error (no live session).
Trust/investment write operations are out of scope unless the official guide documents them. Do not invent them.
Do not hardcode VAT at 14% (2017 examples) or 15%. Callers supply amounts.
Remote / HTTP MCP hosting is out of scope for v1 (stdio only: Cursor, Claude Desktop).
License
Available Tools
8 toolslpza_create_clientB
Create a new client (debtor) via customer.insert. Requires customer_name, customer_code, and department_id.
Inputs: customer_code (required), customer_name (required), department_id (required), tel, +4 more.
lpza_create_matterA
Create a new matter via matter.insert. Fees can only be posted to a matter.
Inputs: customer_id (required), matter_code (required), matter_name (required), dateopened, +2 more.
lpza_create_transferA
Create buyer and seller matters for a conveyancing transfer via matterset.createtransfer.
Inputs: matterset_name (required), buyer_customer_id (required), buyer_matter_code (required), buyer_matter_name (required), +5 more.
lpza_delete_draft_feeA
Delete an unbilled draft fee or disbursement via matterdraftlineitem.quickdelete. Requires confirm: true.
Inputs: confirm (required), srcid, matterdraftlineitem_uid.
lpza_list_unbilledA
List all unbilled (WIP) draft fees and disbursements for a matter via matterdraftlineitem.childlist.
Inputs: matter_id (required), lookup.
lpza_pingA
Confirm the LawPracticeZA MCP server process is running. Does not call the LawPracticeZA API. Live access is not available until credentials are configured.
Inputs: no named parameters.
lpza_update_matterA
Update an existing matter via matter.update. Fetches matter.detail with lookup="" first, merges changes, and POSTs every field (full record, not a partial patch).
Inputs: matter_id (required), fax, cell, email, +14 more.
lpza_upsert_draft_feeA
Insert or update an unbilled draft fee via matterdraftlineitem.upsert. Pass unitprice, tax, and trantotal as supplied — VAT is not calculated in this tool. Update by matterdraftlineitem_uid or srcid.
Inputs: tax (required), matter_id (required), trantotal (required), unitprice (required), +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
All eight tools have clearly distinct purposes: health check, client creation, matter creation/update, transfer creation, listing unbilled items, and upsert/delete of draft fees. No two tools could be confused, and the descriptions reinforce their specific roles.
Every tool follows the consistent pattern 'lpza_' + verb + noun (e.g., create_client, update_matter, list_unbilled, delete_draft_fee). The verb-noun structure is uniform and predictable across the entire set.
Eight tools is well within the ideal range for a focused domain server. Each tool covers a distinct operation needed for managing clients, matters, and unbilled fees without unnecessary redundancy or bloat.
The domain is well covered for core workflows: client creation, matter creation/update, transfer creation, and draft fee lifecycle (upsert/delete/list). Minor gaps include missing client read/update/delete, matter delete/list, and a dedicated matter get, but these can be worked around using existing tools (e.g., update_matter fetches detail).
Maintenance
Related MCP Connectors
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server allowing Clients to interact with Xero Accounting Software15220 npm22MIT
- AlicenseAqualityBmaintenanceMCP server for LawRuler Legal CRM. Provides 15 tools for lead/intake creation, retrieval, and management.15MIT

Vaquill-AI/vaquill-mcpofficial
AlicenseAqualityBmaintenanceMCP server for Vaquill legal research API. Covers US federal + 50-state law (USC, CFR, state legislation, CourtListener case law)37168 PyPI9MIT- AlicenseBqualityDmaintenanceMCP server for PracticePanther legal practice management software. Enables reading and creating matters, contacts, time entries, invoices, and more via natural language.261MIT