mcpField
U
uk-parliament-committees

uk-parliament-committees

Local
github.com/DarkhorseOneLegal & Government1Updated 33w ago
Repository

About uk-parliament-committees

uk-parliament-committees is an MCP server for developers and AI agents working with UK Parliament committee information. It provides API-backed access to committees, business, events, memberships, evidence, petitions, publications, and documents.

Key features

  1. 01Search and retrieve committees and business
  2. 02Query meetings, events, and attendance
  3. 03Access evidence and petitions
  4. 04Retrieve publications and documents
  5. 05Filter results by dates and status

Use cases

  1. 01Summarize committee activity and upcoming meetings
  2. 02Track evidence submissions and publications
  3. 03Monitor committee business status
  4. 04Enrich datasets with committee metadata

MCP support

The stdio MCP server exposes tools that map to the UK Parliament Committees API, including search, lookup, and document retrieval. An HTTP proxy mode is also described.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "nick-ma-uk-parliament-committees": {
      "command": "npx",
      "args": [
        "-y",
        "@darkhorseone/mcp-server-uk-parliament-committees"
      ]
    }
  }
}
Run commandnpx -y @darkhorseone/mcp-server-uk-parliament-committees

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@darkhorseone/mcp-server-uk-parliament-committees1.0.1

Tools

38

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
Skipnumber|stringNoNumbers of items to skip - defaults to 0
Takenumber|stringNoNumber of items to be returned - defaults to 30
EndDatestringNoList of evidence published on or before date provided
StartDatestringNoList of evidence published on or after date provided
SearchTermstringNoSearch by witness names, organisation names, and submission identifiers (where applicable). Must be 2 characters or more.
CommitteeIdnumber|stringNoList of evidence related to a committee with the committee id
ShowOnWebsiteOnlyboolean|stringNoOnly return committee website results - defaults to true
CommitteeBusinessIdnumber|stringNoList of evidence related to a committee business with the committee business id

Details

From the project 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

{
  "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:

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

MCP Configuration

Example mcpServers configuration for stdio transport:

{
  "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:

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

Or install via pnpm from the repository root:

pnpm install

Run (HTTP proxy server)

Build first, then start:

pnpm --filter @darkhorseone/mcp-server-uk-parliament-committees run build
pnpm --filter @darkhorseone/mcp-server-uk-parliament-committees run start:http

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

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

Published package command:

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:

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

Health check:

curl http://127.0.0.1:8787/healthz

Proxy pattern:

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

Example:

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.