Skip to content
MCP server

Uk Parliament Bills

MCP server giving AI clients structured access to UK Parliament bills data

Runs locallyStatus and history
Install
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-bills

Add to claude_desktop_config.json

{
  "mcpServers": {
    "uk-parliament-bills": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "uk-parliament-bills": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-bills"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers