Uk Parliament

npm version License: MIT GitHub

https://github.com/user-attachments/assets/eec2a7bc-1ddf-4b25-8553-8d5b33a57ff6

A Model Context Protocol (MCP) server for live UK Parliament data. Query bills, votes, MP profiles, financial interests, and petitions straight from your MCP‑compatible assistant, no API key required.

---

Features

• No authentication – open data under the Open Parliament Licence
• Rebellion tracking – detect MPs voting against their party whip
• Cross-dataset queries – match vote records against financial interests
• Pattern detection – close votes, government defeats, party rebellion rates
• Bill & petition search – by keyword, stage, or status

---

Installation

# One‑off run
npx uk-parliament-mcp

# Global install
npm install -g uk-parliament-mcp

---

Usage

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "uk-parliament": {
      "command": "npx",
      "args": ["-y", "uk-parliament-mcp"]
    }
  }
}

Claude Code:

claude mcp add uk-parliament -- npx -y uk-parliament-mcp

---

Available Tools

Tool	Purpose
rank_entities	Rank MPs by rebellion count across divisions
get_events	Recent divisions, rebellions, or bills
analyze_patterns	Close votes, government defeats, party rebellion rates
find_entities	Find MPs, bills, petitions, or declared interests
query_entities	Cross-reference vote records with financial interests

---

What You Can Ask

Question	Tool
Which Labour MPs have rebelled most this parliament?	rank_entities
What votes happened in the Commons this week?	get_events
Which Conservative MPs rebelled last month?	get_events
Bills currently about welfare reform?	find_entities
Show me knife-edge votes (10 votes margin or fewer) this year	analyze_patterns
Which government bills were defeated in the Lords?	analyze_patterns
MPs with declared defence company interests	find_entities
Labour MPs who voted No on a Renters Reform Bill with property interests	query_entities
What are the most-signed open petitions right now?	find_entities

---

Data Sources

API	What it covers
bills-api.parliament.uk	Bills, stages, sponsors
commonsvotes-api.parliament.uk	Commons division records
lordsvotes-api.parliament.uk	Lords division records
members-api.parliament.uk	MP and Lord profiles
interests-api.parliament.uk	Register of Members' Financial Interests
petition.parliament.uk	Petitions and signature counts

---

Development

git clone https://github.com/YOUR_USERNAME/uk-parliament-mcp-server.git
cd uk-parliament-mcp-server
npm install
npm run build   # compile TypeScript
npm start       # production
npm run dev     # watch & reload

---

Contributing

1. Fork → branch → commit
2. git push and open a PR
3. Follow the coding style in src/

---

License

MIT – see LICENSE.

---

Disclaimer This project is unofficial and not endorsed by UK Parliament. Data usage is subject to the Open Parliament Licence.