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 typed HTTP client (src/lpza/) and write tools for clients, matters, transfers, and WIP are implemented with fixture-backed tests. Live LawPracticeZA calls require credentials (LPZA_DATABASE, LPZA_LOGIN_CODE, LPZA_PASSWORD); without them, write tools return a configuration error.

• API guide: https://lawpracticeza.com/docs/api_guide.html

• Schema: https://lawpracticeza.com/docs/schema.html

• License: GPL-3.0-only

Requirements

• Node.js 20 or later

• npm

Related MCP server: lawruler-mcp

Run

npm install
npx tsx src/index.ts

Or 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.ts

Environment variables

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):

Once secrets are configured, run:

npm run verify:login

The 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

Planned (not in this release): session/lookup reads, billing with confirm gates, accounting reads, and lpza_api_call.

Development

npm run typecheck
npm test
npm run verify:login   # requires LPZA_* env; see README

CI runs typecheck and tests on push and pull request to main.

HTTP client (src/lpza/)

Fixture tests in tests/lpza-client.test.ts and tests/write-tools.test.ts mock HTTP — no live credentials required.

Limits

• Without env credentials, 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

GNU General Public License v3.0 only.