Uk Parliament Erskinemay

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

MCP server for UK Parliament Erskine May API

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Read-only MCP server that lets an assistant look up and search UK Parliament Erskine May procedural content through the official API.

What you can do
  • Retrieve chapters and parts by number, and list all parts
  • Fetch sections, section overviews and paragraphs by id, step or reference
  • Browse index terms by starting letter and fetch a term by id
  • Search index terms, sections and paragraphs by keyword with skip/take pagination
  • Return structured envelopes that preserve the upstream JSON payload
When to use it
Useful when an assistant needs authoritative UK parliamentary procedure references, such as answering procedural questions, mapping sections and paragraphs for legal or parliamentary research, or enriching civic-tech datasets with Erskine May citations.
Requirements
Runs locally over stdio, typically launched with npx from the npm package, so Node.js and network access to the Erskine May API are needed. No authentication is declared. Optional environment variables set the upstream base URL, request timeout and, for the HTTP proxy mode, the local port.
Before you install
All tools are read-only lookups and searches against a public parliamentary API; queries are sent to that third-party service. The README also documents an HTTP proxy mode that forwards arbitrary upstream paths on a local port, which widens what is reachable beyond the listed tools.

Installation

In SourceWeft

  1. Open Uk Parliament Erskinemay 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 Erskine May MCP Server

Summary

This MCP server provides structured access to UK Parliament Erskine May content using the Model Context Protocol. It enables AI agents to query chapters, parts, sections, and index terms through API-backed tools for reliable data access. Developers can connect the MCP server via stdio transport to retrieve authoritative procedural guidance and references. The server exposes tools that map directly to the Erskine May API for search and lookup workflows.

Features

  • Retrieve chapters, parts, sections, and section overviews by identifier.
  • Browse and search index terms and paragraphs by keyword.
  • Support structured lookups with consistent response envelopes.
  • Preserve upstream JSON payloads for downstream tools and AI agents.

Available Tools

get_chapter_by_chapter_number

Returns a single chapter overview by chapter number.

Parameters:

  • chapterNumber (number, path) – Chapter number.

browse_index_terms

Returns a list of index terms by start letter.

Parameters:

  • startLetter (string, query)
  • skip (number, query)
  • take (number, query)

get_index_term_by_index_term_id

Returns an index term by id.

Parameters:

  • indexTermId (number, path) – Index term id.

list_parts

Returns a list of all parts.

get_part_by_part_number

Returns a part by part number.

Parameters:

  • partNumber (number, path) – Part number.

search_index_term_results_by_search_term

Returns a list of index terms which contain the search term.

Parameters:

  • searchTerm (string, path)
  • skip (number, query)
  • take (number, query)

get_paragraph_by_reference

Returns a section overview by reference.

Parameters:

  • reference (string, path)

search_paragraph_results_by_search_term

Returns a list of paragraphs which contain the search term.

Parameters:

  • searchTerm (string, path)
  • skip (number, query)
  • take (number, query)

search_section_results_by_search_term

Returns a list of sections which contain the search term.

Parameters:

  • searchTerm (string, path)
  • skip (number, query)
  • take (number, query)

get_section_by_section_id

Returns a section by section id.

Parameters:

  • sectionId (number, path)

get_section_overview_by_section_id_and_step

Returns a section overview by section id and step.

Parameters:

  • sectionId (number, path)
  • step (number, path)

Example Output

json
{  "status": 200,  "data": {    "sectionId": 12,    "title": "Order in debate",    "content": "..."  },  "upstream_path": "/api/Section/12",  "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-erskinemay mcp-server-uk-parliament-erskinemay

MCP Configuration

Example mcpServers configuration for stdio transport:

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

Example Usage

  • Fetch a chapter by chapter number.
  • Search sections for a keyword and paginate results.
  • Retrieve a section overview by id and step.
  • Browse index terms starting with a letter.

Use Cases

  • AI agents answering procedural questions with authoritative references.
  • Legal or parliamentary research tools mapping sections and paragraphs.
  • Civic tech workflows enriching datasets with Erskine May references.
  • Automation systems that index procedural content for retrieval.

Data Source

UK Parliament Erskine May API https://erskinemay-api.parliament.uk

Installation

Run directly using npx:

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

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

Published package command:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-erskinemay -- mcp-server-uk-parliament-erskinemay-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-erskinemay -- 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/Part"

License

MIT License

MCP Metadata

Protocol: Model Context Protocol Transport: stdio Tools: get_chapter_by_chapter_number, browse_index_terms, get_index_term_by_index_term_id, list_parts, get_part_by_part_number, search_index_term_results_by_search_term, get_paragraph_by_reference, search_paragraph_results_by_search_term, search_section_results_by_search_term, get_section_by_section_id, get_section_overview_by_section_id_and_step

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