benefits

Kota's CLI for agents and developers. Use it to:

• get group health insurance quotes for companies in the UK and Ireland
• book a consultation call with a Kota benefits specialist about a quote
• install Kota agent skills so coding agents like Claude Code, Cursor and Codex know how to use it

Zero dependencies. Node 18+.

Quotes

npx benefits quote

In a terminal, you'll be asked for anything you didn't pass as a flag. To run it in one go:

npx benefits quote \
  --email [email protected] \
  --company "Acme Ltd" \
  --country UK \
  --employees 25 \
  --average-age 34 \
  --has-policy yes \
  --current-provider Bupa \
  --renewal-date 2027-01-15

| Flag | Required | Description | |---|---|---| | --email | yes | Where to send the quote | | --company | yes | Company name | | --country | yes | UK or IE. Variants like ireland, gb and united kingdom also work | | --employees | yes | Whole number, 2 to 5000 | | --average-age | yes | 16 to 75. A rough figure is fine | | --coverage | no | employee (default) or family | | --has-policy | yes | yes or no: do you have group health insurance today? | | --current-provider | if --has-policy yes | Current insurer | | --renewal-date | if --has-policy yes | YYYY-MM-DD, in the future and within 18 months |

A quote has three tiers (Essential, Standard and Comprehensive). Each tier has a price per employee per month, a monthly total and an annual total, in GBP for the UK or EUR for Ireland. The quote also has a KQ- reference, a 30-day validity date and notes about renewal timing and how pre-existing conditions are underwritten.

For agents

npx benefits quote --schema    # every input as JSON: type, required, enum, description, example command
npx benefits quote ... --json  # machine-readable output, never prompts

With --json, or whenever stdin or stdout isn't a terminal, the CLI never prompts. Invalid or missing input exits with code 2 and lists every problem at once:

{ "ok": false, "errors": [{ "field": "employees", "message": "Must be between 2 and 5000." }] }

A successful quote exits with code 0 and prints { "ok": true, "reference": "KQ-...", "tiers": [...], ..., "nextStep": {...} }. nextStep.command is the ready-to-run command for booking a consultation call about the quote.

Consultation calls

npx benefits book --reference KQ-7H3K9P --email [email protected] --preferred-time "Tuesday afternoon" --json

Books a free 30-minute call with a Kota benefits specialist to talk through a quote. --preferred-time is optional free text. It supports --json and --schema, and reports errors the same way as quote, with exit code 2. The result has a KB- booking reference and "status": "requested".

Agent skills

npx benefits list              # list the bundled skills
npx benefits add quote         # install benefits-quote into ./.claude/skills
npx benefits add quote --dir .cursor/skills

Short names work, so quote installs benefits-quote. Add --force to replace a skill you've already installed, and --json for machine-readable output.

| Skill | What it does | |---|---| | benefits-quote | Teaches an agent to collect a company's details, run benefits quote --json, handle errors and present the tiers, then offer to book a consultation call. |

Development

bin/benefits.js     command routing and help text
src/args.js         argument parsing
src/quote.js        quote inputs, validation, prompts, output; priceQuote() holds the pricing
src/book.js         consultation booking; bookCall() holds the booking
src/skills.js       list and add
skills/<name>/      bundled skills, one SKILL.md each

priceQuote() in src/quote.js and bookCall() in src/book.js are where Kota's quoting and booking APIs plug in.