# Uk Parliament Bills

> Uk Parliament Bills is an open-source MCP server for legal and government. MCP server giving AI clients structured access to UK Parliament bills data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/darkhorseone/mcp-servers/tree/HEAD/servers/uk-parliament-bills
- **MCP Registry name:** io.github.nick-ma/uk-parliament-bills
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add uk-parliament-bills -- npx -y @darkhorseone/mcp-server-uk-parliament-bills
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "uk-parliament-bills": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "uk-parliament-bills": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "uk-parliament-bills": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "uk-parliament-bills": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "uk-parliament-bills": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Eu Parliament](https://ai-powered.com/mcp/eu-parliament): Eu Parliament is a freemium MCP server for legal and government.
- [us-congress-watch](https://ai-powered.com/mcp/us-congress-watch): us-congress-watch is a paid MCP server for legal and government.
- [Bundestag De](https://ai-powered.com/mcp/bundestag-de): Bundestag De is a freemium MCP server for legal and government.
- [India Law](https://ai-powered.com/mcp/india-law): India Law is a freemium MCP server for legal and government.
- [Gov Uk Content](https://ai-powered.com/mcp/gov-uk-content): Gov Uk Content is a freemium MCP server for legal and government.
- [Pandex](https://ai-powered.com/mcp/pandex): Pandex is a freemium MCP server for legal and government.
- [UK Law](https://ai-powered.com/mcp/uk-law): UK Law is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/uk-parliament-bills
