Uk Parliament Bills
MCP server giving AI clients structured access to UK Parliament bills data
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- today
Similar MCP servers
About Uk Parliament Bills
Uk Parliament Bills is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.
The README describes this server as a bridge between AI clients and the UK Parliament Bills API. It exposes tools to search bills, look up individual bill stages, read amendments and ping-pong items, list publications and download publication documents, and pull sittings and RSS feeds for all, public or private bills.
Each tool maps to an upstream endpoint and returns the upstream JSON inside a consistent envelope that includes the status, the upstream path and a retrieval timestamp. The package runs over stdio using npx, and the README also documents an optional HTTP proxy mode with a health check and a path-based passthrough to the upstream API.
It suits developers building legislative tracking tools, civic technology projects, or agent workflows that need current bill status and amendment history without writing their own API client.
Install
Run in a terminal
claude mcp add uk-parliament-bills -- npx -y @darkhorseone/mcp-server-uk-parliament-billsAdd to claude_desktop_config.json
{
"mcpServers": {
"uk-parliament-bills": {
"command": "npx",
"args": [
"-y",
"@darkhorseone/mcp-server-uk-parliament-bills"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"uk-parliament-bills": {
"command": "npx",
"args": [
"-y",
"@darkhorseone/mcp-server-uk-parliament-bills"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"uk-parliament-bills": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@darkhorseone/mcp-server-uk-parliament-bills"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"uk-parliament-bills": {
"command": "npx",
"args": [
"-y",
"@darkhorseone/mcp-server-uk-parliament-bills"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"uk-parliament-bills": {
"command": "npx",
"args": [
"-y",
"@darkhorseone/mcp-server-uk-parliament-bills"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (21)
Taken from the project documentation; the running server may differ.
- search_bill_stage_amendments
- Returns a list of amendments for a Bill stage.
- get_bill_stage_amendment
- Returns a specific amendment for a Bill stage.
- list_bill_news_articles
- Returns news articles for a Bill.
- list_bill_types
- Returns a list of Bill types.
- search_bills
- Returns a list of Bills matching filters.
- get_bill
- Returns a Bill.
- get_bill_stage_details
- Returns a Bill stage.
- list_bill_stages
- Returns all Bill stages for a Bill.
- get_publication_document
- Returns information on a publication document.
- download_publication_document
- Returns a publication document payload.
- search_bill_stage_ping_pong_items
- Returns a list of motions or amendments for a Bill stage.
- get_bill_stage_ping_pong_item
- Returns an amendment or motion detail.
- list_publication_types
- Returns a list of publication types.
- list_bill_publications
- Returns Bill publications.
- list_bill_stage_publications
- Returns publications for a Bill stage.
- get_rss_all_bills
- Returns an RSS feed for all Bills.
- get_rss_public_bills
- Returns an RSS feed for public Bills.
- get_rss_private_bills
- Returns an RSS feed for private Bills.
- get_rss_bill_by_id
- Returns an RSS feed for a specific Bill.
- search_sittings
- Returns a list of sittings.
- list_stage_references
- Returns a list of Bill stages.
What it does
- Bill and stage search
- Search bills by text and filters such as session, house, bill type and stage, and fetch individual bills or stages.
- Amendments and ping-pong items
- Retrieve amendments and motions for a bill stage, with filters for decision, amendment number and member.
- Publication downloads
- List bill and stage publications and fetch or download publication documents by ID.
- RSS feed access
- Return RSS feeds for all, public or private bills, or for a single bill, as raw text.
- Sittings lookup
- Search parliamentary sittings by house and date range.
- Envelope-wrapped responses
- Upstream JSON is preserved and wrapped with status, upstream path and retrieval time.
Good for
- Having an AI agent summarise where a bill stands in the legislative process
- Monitoring bill updates through the API or RSS feeds in a developer tool
- Tracking amendments and parliamentary stages for civic technology projects
- Enriching datasets with UK Parliament bill metadata in automation pipelines
Pricing
Open source
Free and MIT licensed; self-hosted.
Uk Parliament Bills FAQ
How is the server run?
The README gives an npx command for stdio transport and a separate HTTP proxy mode that defaults to port 3000.
Does it need an API key?
The package lists no environment variables in its registry entry; the example configuration only sets the upstream base URL and a request timeout.
What is the licence?
The README states the MIT License.
Is Uk Parliament Bills free?
Yes. Uk Parliament Bills is open source, so you can use and self-host it for free.
How do I add Uk Parliament Bills to Claude Code?
Run this command in your terminal: claude mcp add uk-parliament-bills -- npx -y @darkhorseone/mcp-server-uk-parliament-bills
What are the best alternatives to Uk Parliament Bills?
The closest alternatives to Uk Parliament Bills are Eu Parliament, us-congress-watch, Bundestag De, India Law and Gov Uk Content.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
