mcp server

uk-parliament-mcp-server

MCP server that gives any AI assistant live access to UK Parliament data: voting history, MP profiles, financial interests, rebellions, bills, and petitions. No API key needed.

kupad95/uk-parliament-mcp-servercommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

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

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 25, 2026

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

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 push and 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.