UK Parliament MCP Server
Hosts the MCP server repository and provides version control for the UK Parliament data integration project, enabling collaborative development and distribution of the server.
Serves as the package registry for distributing and installing the UK Parliament MCP server, allowing users to easily install and run the server via npm commands.
Used as the implementation language for developing the MCP server, providing type safety and modern JavaScript features for building the UK Parliament data integration.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UK Parliament MCP Server Which Labour MPs have rebelled most during this parliament?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
UK Parliament MCP Server
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
Related MCP server: mcp-eu-parliament
Installation
# One‑off run
npx uk-parliament-mcp
# Global install
npm install -g uk-parliament-mcpUsage
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-mcpAvailable Tools
Tool | Purpose |
| Rank MPs by rebellion count across divisions |
| Recent divisions, rebellions, or bills |
| Close votes, government defeats, party rebellion rates |
| Find MPs, bills, petitions, or declared interests |
| Cross-reference vote records with financial interests |
What You Can Ask
Question | Tool |
Which Labour MPs have rebelled most this parliament? |
|
What votes happened in the Commons this week? |
|
Which Conservative MPs rebelled last month? |
|
Bills currently about welfare reform? |
|
Show me knife-edge votes (10 votes margin or fewer) this year |
|
Which government bills were defeated in the Lords? |
|
MPs with declared defence company interests |
|
Labour MPs who voted No on a Renters Reform Bill with property interests |
|
What are the most-signed open petitions right now? |
|
Data Sources
API | What it covers |
| Bills, stages, sponsors |
| Commons division records |
| Lords division records |
| MP and Lord profiles |
| Register of Members' Financial Interests |
| 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 & reloadContributing
Fork → branch → commit
git pushand open a PRFollow 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.
Available Tools
5 toolsanalyze_patternsA
Detect patterns across many parliamentary votes: 'close_votes' finds divisions with a small margin (near-misses or knife-edge votes), 'government_defeats' finds votes the government lost, 'party_rebellion_rate' shows which parties rebel most by percentage of votes cast. Use for trend analysis across many divisions.
Inputs: pattern_type (required), house, days, threshold, +2 more.
find_entitiesA
Find MPs, bills, petitions, or declared financial interests. entity_type='mp': search members by name/party/constituency/house/status. entity_type='bill': search legislation by title keyword/stage/house. entity_type='petition': find petitions by keyword. entity_type='interest': fetch an MP's declared financial interests. Pass name='John McDonnell' OR mp_id=178 (member ID from a prior MP lookup). Optionally add keyword to filter by topic (e.g. keyword='property'). To find ALL MPs with a given interest topic, omit name/mp_id and pass only keyword='defence'.
Inputs: entity_type (required), name, mp_id, party, +7 more.
get_eventsA
Get recent parliamentary events: votes/divisions, party rebellions, bill stage changes, or a specific MP's voting record. event_type='division': recent votes with pass/fail results. event_type='rebellion': divisions with party rebels, optionally filtered by party. event_type='bill': bills filtered by stage or keyword. event_type='member_votes': full voting history for a specific MP — pass name='Nigel Farage' (or mp_id if already known). Shows each division, how the MP voted (Aye/No), and the result.
Inputs: event_type (required), house, party, name, +5 more.
query_entitiesA
Cross-dataset query: find MPs matching multiple conditions spanning vote records AND financial interests. Examples: 'Labour MPs who voted No on division 1234', 'MPs who rebelled in division 5678 AND have defence interests', 'MPs with fossil fuel interests who voted Aye'. Specify division_id with voted='aye'/'no' or rebellion_only=true for vote filter. Specify has_interest keyword for interest filter. Results are the intersection of all conditions.
Inputs: division_id, voted, rebellion_only, house, +3 more.
rank_entitiesA
Rank MPs by rebellion count — how many times they voted against their party whip. Use this for any question about 'most rebellious MPs', 'rebel count', 'which Labour/Conservative MPs rebelled most', or rebellion frequency rankings. Scans all divisions in the date range internally and returns a sorted leaderboard in a single call. Filter by party='Labour' for Labour-specific results.
Inputs: entity_type (required), metric (required), party, house, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: aggregate pattern analysis, entity search, recent events, cross-dataset queries, and rebellion rankings. The purposes are clearly separated with no ambiguity.
All tool names follow a consistent verb_entity pattern (analyze_patterns, find_entities, get_events, query_entities, rank_entities) using snake_case, making the set highly predictable.
With 5 tools covering MPs, bills, petitions, interests, votes, and rebellions, the scope is well-balanced. Each tool serves a clear purpose without redundancy or overload.
The toolset covers core query capabilities for UK Parliament data, but lacks a direct tool for retrieving detailed information about a specific division by ID. Minor gap, but overall surface is solid for typical use cases.
Related MCP Connectors
Search MPs and Lords, fetch profiles, synopses, and Westminster constituencies
UK Parliament MCP — Members, Bills, Hansard APIs
Query UK Parliament, elections, crime stats, ONS census data, and national archives
GovTrack MCP — federal US Congress data (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides access to Canadian federal parliamentary data (debates, bills, MPs, votes, Hansard transcripts) and legal information (case law and legislation through CanLII) for research and analysis.3MIT
- AlicenseNot gradedqualityCmaintenanceProvides access to European Parliament open data, enabling queries about MEPs, plenary documents, and session calendar.96 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides live, source-linked transparency data on German MPs, including roll-call voting, side jobs, committee memberships, and election programs, via the Abgeordnetenwatch API. No API key required.AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables querying UK Parliament data including MPs, Lords, bills, Hansard debates, and divisions.278 npmMIT