Uk Parliament Committees

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

MCP server for UK Parliament Committees API

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Local MCP server giving an assistant read-only access to UK Parliament Committees data: committees, business, events, publications, evidence and petitions.

What you can do
Look up committees, committee types, memberships, staff and lay-member photos, with filters for house, status and category, plus next events per committee and memberships by member id. Search committee business, business types and publication groups, and filter by status, dates and whether petitions or evidence are open. List events, activities, attendances and banners, with date, house, location and event-type filters. Retrieve publications, publication types, documents in original, HTML or PDF format, and submission period details and templates. Fetch oral and written evidence, bill petitions and their documents, and a list of countries.
When to use it
Useful for research, civic-tech or journalism work that needs authoritative UK parliamentary committee information: summarising committee activity, tracking evidence submissions and publications, or monitoring committee business statuses.
Requirements
Runs locally as a Node.js process, started with npx from the npm package. Network access to the UK Parliament Committees API is required; the README shows optional environment variables for the API base URL and request timeout, and an optional HTTP proxy mode with a port setting.
Before you install
Read-only access to public parliamentary data; no credentials are declared. Queries and search terms are sent to the external UK Parliament Committees API, and the optional HTTP proxy mode exposes a local port that forwards requests upstream.

Installation

In SourceWeft

  1. Open Uk Parliament Committees 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 Committees MCP Server

Summary

This MCP server provides structured access to UK Parliament Committees data using the Model Context Protocol. It enables AI agents to query committees, committee business, events, publications, evidence, and petitions via API-backed tools and data access. Developers can connect the MCP server through stdio transport for reliable automation and AI agents that need authoritative committee information. The server exposes tools that map directly to the Committees API, supporting search, lookup, and document retrieval workflows.

Features

  • Retrieve committees, committee types, and committee business with structured filters.
  • Access meetings, events, activities, and attendance data with date and status parameters.
  • Fetch publications, evidence, petitions, and related documents with consistent responses.
  • Preserve upstream payloads in a standardized envelope for downstream tools and AI agents.

Available Tools

get_bill_petitions

Return a list of Bill petitions.

Parameters:

  • CommitteeBusinessId (number, query) – Committee business id filter.
  • CommitteeId (number, query) – Committee id filter.
  • SearchTerm (string, query) – Search by witness/organisation/identifier.
  • StartDate (string, query) – Published on or after date.
  • EndDate (string, query) – Published on or before date.
  • ShowOnWebsiteOnly (boolean, query) – Website-only results.
  • Skip (number, query) – Offset.
  • Take (number, query) – Limit.

get_bill_petition_by_id

Return a Bill petition.

Parameters:

  • id (number, path) – Bill petition id.
  • showOnWebsiteOnly (boolean, query) – Website-only results.

get_bill_petition_document

Return a document for a Bill petition.

Parameters:

  • id (number, path) – Petition id.
  • fileDataFormat (string, path) – OriginalFormat | Html | Pdf.

get

Get a list of Committee Meetings between two dates.

Parameters:

  • FromDate (string, query) – From date (yyyy-mm-dd).
  • ToDate (string, query) – To date (yyyy-mm-dd).

get_committee_business

Return a list of committee businesses.

Parameters:

  • SearchTerm (string, query)
  • CommitteeId (number, query)
  • DateFrom (string, query)
  • DateTo (string, query)
  • BusinessTypeId (number, query)
  • Status (string, query) – Open | Closed
  • CurrentlyAcceptingPetitions (boolean, query)
  • CurrentlyAcceptingEvidence (boolean, query)
  • SortOrder (string, query) – DateOpenedNewest | DateOpenedOldest | PublicationDateAscending | PublicationDateDescending
  • CommitteeBusinessIds (array:number, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_committee_business_by_id

Return a committee business.

Parameters:

  • id (number, path) – Committee business id.
  • includeBanners (boolean, query)
  • showOnWebsiteOnly (boolean, query)

list_committee_business_publication_groups

Return a list of Publication Groups for a Committee Business.

Parameters:

  • id (number, path) – Committee business id.

list_committee_business_types

Return a list of Committee Business Types.

list_committee_types

Return a list of Committee Types.

get_committees

Return a list of Committees.

Parameters:

  • CommitteeBusinessId (number, query)
  • SearchTerm (string, query)
  • ParentCommitteeId (number, query)
  • CommitteeStatus (string, query) – Current | Former | All
  • CommitteeTypeId (number, query)
  • CommitteeCategory (string, query) – Select | General | Other
  • House (string, query) – Commons | Lords | Joint
  • CommitteeIds (array:number, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_next_event_for_committees

Return a list of next events for committees matching specified criteria.

Parameters:

  • EventWithActivitiesOnly (boolean, query)
  • EventFromDate (string, query)
  • House (string, query) – Commons | Lords | Joint
  • EventTypes (array:number, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_committee_by_id

Return a Committee.

Parameters:

  • id (number, path) – Committee id.
  • includeBanners (boolean, query)
  • showOnWebsiteOnly (boolean, query)

get_events_committee_by_id

Return events related to the committee id provided.

Parameters:

  • id (number, path) – Committee id.
  • CommitteeBusinessId (number, query)
  • SearchTerm (string, query)
  • StartDateFrom (string, query)
  • StartDateTo (string, query)
  • EndDateFrom (string, query)
  • House (string, query) – Commons | Lords | Joint
  • LocationId (number, query)
  • ExcludeCancelledEvents (boolean, query)
  • SortAscending (boolean, query)
  • EventTypeId (number, query)
  • IncludeEventAttendees (boolean, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

list_committee_memberships

Return a list of Memberships of a Committee.

Parameters:

  • id (number, path) – Committee id.
  • MembershipStatus (string, query) – Current | Former | All
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_committee_person_photo

Return photo for a lay member of the committee.

Parameters:

  • id (number, path) – Committee id.
  • personId (number, path) – Person id.

list_committee_staff_memberships

Return a list of staff members of a Committee.

Parameters:

  • id (number, path) – Committee id.
  • MembershipStatus (string, query) – Current | Former | All
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

list_committee_publication_groups

Return a list of Publication Groups for a Committee.

Parameters:

  • id (number, path) – Committee id.

get_committee_archived_publication_links

Return all CommitteeArchivedPublicationLinks linked to a Committee.

Parameters:

  • id (number, path) – Committee id.

get_countries

Return a list of Countries.

get_events

Return a list of events.

Parameters:

  • CommitteeId (number, query)
  • CommitteeBusinessId (number, query)
  • GroupChildEventsWithParent (boolean, query)
  • SearchTerm (string, query)
  • StartDateFrom (string, query)
  • StartDateTo (string, query)
  • EndDateFrom (string, query)
  • House (string, query) – Commons | Lords | Joint
  • LocationId (number, query)
  • ExcludeCancelledEvents (boolean, query)
  • SortAscending (boolean, query)
  • EventTypeId (number, query)
  • IncludeEventAttendees (boolean, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_event_activities

Return a list of event activities.

Parameters:

  • IncludeActivityAttendees (boolean, query)
  • CommitteeId (number, query)
  • CommitteeBusinessId (number, query)
  • GroupChildEventsWithParent (boolean, query)
  • SearchTerm (string, query)
  • StartDateFrom (string, query)
  • StartDateTo (string, query)
  • EndDateFrom (string, query)
  • House (string, query) – Commons | Lords | Joint
  • LocationId (number, query)
  • ExcludeCancelledEvents (boolean, query)
  • SortAscending (boolean, query)
  • EventTypeId (number, query)
  • IncludeEventAttendees (boolean, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_event_by_id

Return an event.

Parameters:

  • id (number, path) – Event id.
  • showOnWebsiteOnly (boolean, query)

get_attendances_by_id

Return a list of attendances for an event.

Parameters:

  • id (number, path) – Event id.
  • showOnWebsiteOnly (boolean, query)

get_activities_by_id

Return a list of activities for an event.

Parameters:

  • id (number, path) – Event id.
  • showOnWebsiteOnly (boolean, query)

list_members_committee_memberships

Return a list of memberships for one or more members.

Parameters:

  • Members (array:number, query) – Member ids.
  • MembershipStatus (string, query) – Current | Former | All
  • CommitteeCategory (string, query) – Select | General | Other
  • ShowOnWebsiteOnly (boolean, query)

banners

Return messaging banners.

Parameters:

  • location (string, path) – Banner location.

get_oral_evidence

Return a list of Oral Evidence.

Parameters:

  • CommitteeBusinessId (number, query)
  • CommitteeId (number, query)
  • SearchTerm (string, query)
  • StartDate (string, query)
  • EndDate (string, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_oral_evidence_by_id

Return an Oral Evidence.

Parameters:

  • id (number, path) – Oral evidence id.
  • showOnWebsiteOnly (boolean, query)

get_oral_evidence_document

Return a document for an Oral Evidence.

Parameters:

  • id (number, path) – Oral evidence id.
  • fileDataFormat (string, path) – OriginalFormat | Html | Pdf.

list_publication_types

Return a list of Publication Types.

get_publications

Return a list of publications.

Parameters:

  • PublicationTypeIds (array:number, query)
  • SearchTerm (string, query)
  • StartDate (string, query)
  • EndDate (string, query)
  • SortOrder (string, query) – PublicationDateDescending | PublicationDateAscending | ResponseDateDescending | ResponseDateAscending
  • PaperNumbers (array:string, query)
  • CommitteeBusinessId (number, query)
  • CommitteeId (number, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_publication_by_id

Return a publication.

Parameters:

  • id (number, path) – Publication id.
  • showOnWebsiteOnly (boolean, query)

get_document

Return a document for a publication.

Parameters:

  • id (number, path) – Publication id.
  • documentId (number, path) – Document id.
  • fileDataFormat (string, path) – OriginalFormat | Html | Pdf.

get_submission_period_template_document_by_id

Return a submission period template file.

Parameters:

  • id (number, path) – Submission period template id.
  • documentId (number, path) – Document id.

get_submission_period_by_id

Return a submission period.

Parameters:

  • id (number, path) – Submission period id.

get_written_evidence

Return a list of Written Evidence.

Parameters:

  • CommitteeBusinessId (number, query)
  • CommitteeId (number, query)
  • SearchTerm (string, query)
  • StartDate (string, query)
  • EndDate (string, query)
  • ShowOnWebsiteOnly (boolean, query)
  • Skip (number, query)
  • Take (number, query)

get_written_evidence_by_id

Return a Written Evidence.

Parameters:

  • id (number, path) – Written evidence id.
  • showOnWebsiteOnly (boolean, query)

get_written_evidence_document

Return a document for a Written Evidence.

Parameters:

  • id (number, path) – Written evidence id.
  • fileDataFormat (string, path) – OriginalFormat | Html | Pdf.

Example Output

json
{  "status": 200,  "data": {    "items": [      {        "committeeId": 123,        "name": "Select Committee on Energy",        "house": "Commons",        "status": "Current"      }    ],    "totalResults": 1  },  "upstream_path": "/api/Committees",  "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-committees mcp-server-uk-parliament-committees

MCP Configuration

Example mcpServers configuration for stdio transport:

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

Example Usage

  • List current committees in the House of Commons.
  • Find committee business by keyword and filter by status.
  • Retrieve events for a committee within a date range.
  • Download a committee publication document as PDF.

Use Cases

  • AI agents summarizing committee activity and upcoming meetings.
  • Research tools tracking evidence submissions and publications.
  • Civic technology platforms monitoring committee business statuses.
  • Automation systems enriching datasets with committee metadata.

Data Source

UK Parliament Committees API https://committees-api.parliament.uk/index.html

Installation

Run directly using npx:

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

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-committees run buildpnpm --filter @darkhorseone/mcp-server-uk-parliament-committees run start:http

Set a custom HTTP port with the UKPCOM_HTTP_PORT environment variable (default: 8787):

bash
UKPCOM_HTTP_PORT=8787 pnpm --filter @darkhorseone/mcp-server-uk-parliament-committees run start:http

Published package command:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-committees -- mcp-server-uk-parliament-committees-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-committees -- node ./dist/http.js

Health check:

bash
curl http://127.0.0.1:8787/healthz

Proxy pattern:

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

Example:

bash
curl "http://127.0.0.1:8787/proxy/api/Committees?Take=5"

License

MIT License

MCP Metadata

Protocol: Model Context Protocol Transport: stdio Tools: get_bill_petitions, get_bill_petition_by_id, get_bill_petition_document, get, get_committee_business, get_committee_business_by_id, list_committee_business_publication_groups, list_committee_business_types, list_committee_types, get_committees, get_next_event_for_committees, get_committee_by_id, get_events_committee_by_id, list_committee_memberships, get_committee_person_photo, list_committee_staff_memberships, list_committee_publication_groups, get_committee_archived_publication_links, get_countries, get_events, get_event_activities, get_event_by_id, get_attendances_by_id, get_activities_by_id, list_members_committee_memberships, banners, get_oral_evidence, get_oral_evidence_by_id, get_oral_evidence_document, list_publication_types, get_publications, get_publication_by_id, get_document, get_submission_period_template_document_by_id, get_submission_period_by_id, get_written_evidence, get_written_evidence_by_id, get_written_evidence_document

Source: servers/uk-parliament-committees/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.