- name
- parliament-cli
- description
- UK Parliament CLI — search bills, divisions, members, and written questions from official UK Parliament APIs, with stable JSON envelopes for agents. Use when looking up UK Parliament bills, members, votes/divisions, written questions, or when an agent needs structured Parliament API results.
- homepage
- https://www.parliment-cli.xyz
- metadata
parliament-cli
Use parliament for UK Parliament data: bills, members, divisions/votes, and written questions.
Setup
npm install -g @shan8851/parliament-cli- No API key or auth required
Bills
- By id:
parliament bill 3973 - By title:
parliament bill "renters rights" - Search:
parliament search bills "energy"
Divisions and Votes
- Search divisions:
parliament divisions "budget" - Lookup by id:
parliament divisions 2211 - Alias:
parliament votes 2211
Members
- By name:
parliament member "Keir Starmer" - By id:
parliament member 4514
Written Questions
- Search:
parliament questions "transport" - Lookup by id or UIN query:
parliament questions 902178
Output
- Defaults to text in a TTY and JSON when piped
- Force JSON:
parliament bill 3973 --json - Success envelope:
{ ok, schemaVersion, command, requestedAt, data } - Error envelope:
{ ok, schemaVersion, command, requestedAt, error }
Agent Notes
- Ambiguous text queries return
AMBIGUOUS_QUERYwith candidate hints inerror.details - No auth setup needed, so agents can use it immediately
- Exit codes are explicit and errors stay structured in JSON mode
Notes
- Official sources include the Bills, Members, Written Questions, and Commons Votes APIs
votesis an alias ofdivisions