Uk Parliament Mcp Server

UK Parliament MCP Server

[](https://badge.fury.io/js/uk-parliament-mcp) [](https://opensource.org/licenses/MIT) [](https://github.com/kupad95/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

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.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kupad95
• Source: kupad95/uk-parliament-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.