UK Parliament MCP Server
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
- Fork → branch → commit
git pushand open a PR- 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.