# Zulu

> NZ-made all-in-one business platform: 20+ modules (CRM, invoicing, products, inventory,
> purchasing, job cards, forms and more) behind a single REST API that AI agents can operate
> end-to-end on a business owner's behalf. Built as a structured, API-complete system —
> not a chatbot bolted onto legacy software.

## Capabilities (live API today)
- CRM & contacts, invoicing, product catalogue, inventory (stock + purchase orders),
  suppliers, job cards, forms (read), file uploads, website/content (posts), tenant info
- Roadmap (module exists, API coming): quoting, orders/fulfilment, point of sale,
  subscriptions, scheduling, pipeline, KPIs, timesheets and more
- Auth: bearer tenant API keys (`zulu_{64-hex}`); scoped per user
- OpenAPI 3 spec available; official MCP server (`@getzulu/mcp`) and terminal CLI (`@getzulu/cli`) published on npm — read-only today; webhooks planned

## Key resources
- API base: https://dashboard.getzulu.io/api/v1
- API reference: https://getzulu.io/developers/
- OpenAPI spec: https://getzulu.io/openapi.json
- Agent onboarding: https://getzulu.io/for-ai-agents/
- MCP server (npm): https://www.npmjs.com/package/@getzulu/mcp
- CLI (npm): https://www.npmjs.com/package/@getzulu/cli
- Pricing: https://getzulu.io/pricing/

## Getting started
- Free trial, no credit card. Agents self-signup via the public API: `POST /account/signup` with `fields.modules` (module opt_keys to enable) — the cheapest covering plan is auto-selected and a scoped tenant `api_key` is returned. Fetch the valid keys first with `GET /account/modules` (public) rather than guessing.
- Activate the account: `POST /account/verify` with the 6-digit code emailed to the owner; the api_key goes live once verified.
- Or generate an API key from your Zulu account settings.
- Authenticate: `Authorization: Bearer zulu_{key}` — scopes are per user.
- First calls: `GET /tenant_info` (context) then `GET /client` / `POST /client`.
- MCP server (read-only): `claude mcp add getzulu -e ZULU_API_TOKEN=zulu_… -- npx -y @getzulu/mcp` — 24 tools (tenant, clients, suppliers, products, stock, invoices, purchase orders, job cards, posts, notes, forms, submissions) over the same REST API. Local stdio; the token stays on your machine.
- CLI (read-only): `npm install -g @getzulu/cli`, then `getzulu setup` with an API token. Commands read as `getzulu <resource> <action>` (alias `zulu`) and output raw API JSON.
- The MCP server and CLI are read-only today — for writes (create/update), call the REST API directly.

## Notes for agents
- Each marketing module page maps to an API resource; live modules show real requests.
- A free/trial account is limited (e.g. 10 clients, 5 quotes/month, 5 sales/month) until upgraded.
- See llms-full.txt for the complete per-module endpoint list.