Uk Parliament Now

io.github.nick-maPublished by GitHub account nick-mav1.0.1Updated Oct 24, 2026

MCP server for UK Parliament NOW Annunciator Content API

VerifiedSTDIODesktop onlyWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Local MCP server that lets an assistant read current and historical UK Parliament NOW Annunciator messages for the Commons and Lords.

What you can do
Retrieve the current annunciator message for the Commons or Lords main channel, with the annunciator type constrained to CommonsMain or LordsMain. Fetch the most recent message for a chosen annunciator after a given ISO date and time. Return upstream payloads in a standardized envelope with status, data, upstream path and retrieval time.
When to use it
Useful for civic tech, monitoring dashboards or automation that needs live or recent parliamentary session status from the UK Parliament NOW Annunciator feed, and for agents reporting Commons or Lords sitting messages.
Requirements
Runs as a local stdio process, typically launched with npx, so Node.js and network access to the UK Parliament NOW API are needed. The README's example configuration sets UPSTREAM_BASE_URL and REQUEST_TIMEOUT_MS; no authentication is declared.
Before you install
Read-only retrieval of public parliamentary data; no credentials, payments or write actions are shown. The README also documents an HTTP proxy mode that forwards requests to upstream paths and a configurable port, which widens local network exposure if enabled.

Installation

In SourceWeft

  1. Open Uk Parliament Now in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[MCP Compatible] [AI Agent Ready]

UK Parliament NOW Annunciator MCP Server

Summary

This MCP server provides structured access to UK Parliament NOW Annunciator data using the Model Context Protocol. It enables AI agents to retrieve current and historical annunciator messages through API-backed tools and data access. Developers can integrate the MCP server via stdio transport to query message feeds for Commons and Lords. The server exposes tools that map directly to the NOW Annunciator API for automation and AI agents workflows.

Features

  • Retrieve the current annunciator message for Commons or Lords.
  • Fetch the latest message after a specific date and time.
  • Enforce annunciator enum constraints for reliable queries.
  • Preserve upstream payloads in a standardized envelope for downstream tools.

Available Tools

get_current_message_by_annunciator

Return the current message by annunciator type.

Parameters:

  • annunciator (string, path) – CommonsMain | LordsMain.

get_latest_message_by_annunciator_and_date

Return the most recent message by annunciator after date time specified.

Parameters:

  • annunciator (string, path) – CommonsMain | LordsMain.
  • date (string, path) – ISO date-time string.

Example Output

json
{  "status": 200,  "data": {    "annunciator": "CommonsMain",    "message": "The House is sitting",    "timestamp": "2026-03-11T09:00:00Z"  },  "upstream_path": "/api/Message/message/CommonsMain/current",  "retrieved_at": "2026-03-11T10:00:00.000Z"}

Quick Start

Run the MCP server using npx:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-now mcp-server-uk-parliament-now

MCP Configuration

Example mcpServers configuration for stdio transport:

json
{  "mcpServers": {    "uk-parliament-now": {      "command": "npx",      "args": ["-y", "-p", "@darkhorseone/mcp-server-uk-parliament-now", "mcp-server-uk-parliament-now"],      "env": {        "UPSTREAM_BASE_URL": "https://now-api.parliament.uk",        "REQUEST_TIMEOUT_MS": "10000"      }    }  }}

Example Usage

  • Retrieve the current Commons annunciator message.
  • Fetch the latest Lords message after a given timestamp.
  • Monitor annunciator updates for session status changes.

Use Cases

  • AI agents reporting live parliamentary status updates.
  • Monitoring dashboards showing Commons/Lords session messages.
  • Civic tech tools tracking sittings and announcements.
  • Automation workflows that trigger on annunciator updates.

Data Source

UK Parliament NOW Annunciator Content API https://now-api.parliament.uk

Installation

Run directly using npx:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-now mcp-server-uk-parliament-now

Or install via pnpm from the repository root:

bash
pnpm install

Run (HTTP proxy server)

Build first, then start:

bash
pnpm --filter @darkhorseone/mcp-server-uk-parliament-now run buildpnpm --filter @darkhorseone/mcp-server-uk-parliament-now run start:http

Set a custom HTTP port with the UKP_HTTP_PORT environment variable (default: 3000):

bash
UKP_HTTP_PORT=3000 pnpm --filter @darkhorseone/mcp-server-uk-parliament-now run start:http

Published package command:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-now -- mcp-server-uk-parliament-now-http

If your shell cannot resolve the bin ("command not found"), run the HTTP entrypoint directly:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-now -- node ./dist/http.js

Health check:

bash
curl http://127.0.0.1:3000/healthz

Proxy pattern:

text
GET /proxy/<upstream-path>?<query>

Example:

bash
curl "http://127.0.0.1:3000/proxy/api/Message/message/CommonsMain/current"

License

MIT License

MCP Metadata

Protocol: Model Context Protocol Transport: stdio Tools: get_current_message_by_annunciator, get_latest_message_by_annunciator_and_date

Source: servers/uk-parliament-now/README.md at commit 38e74c9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.