Uk Parliament Statutoryinstruments

io.github.nick-ma由 GitHub 帳號 nick-ma 發布v1.0.1更新於 Oct 24, 2026

MCP server for UK Parliament Statutory Instruments API

概覽

AI 產生的概覽

唯讀 MCP 伺服器,讓助理檢索英國議會法定文書、擬議否定決議、程序、提交機構與議會法案。

可以做什麼
依院別、程序、類型、部門與狀態等條件搜尋並列出法定文書與擬議否定決議,涵蓋 v1 與 v2 端點,支援 Skip 與 Take 分頁。依 ID 取得單一法定文書、擬議否定決議、程序、業務事項或議會法案。列出與某文書、擬議否定決議或時間軸相關的業務事項。查詢所有提交機構與程序。以上游原始內容加上統一信封回傳,含狀態、路徑與取得時間。
適用情境
適合需要英國法定文書狀態、程序、主管部門或相關議會事務的研究、公民科技或報告工作,也方便在不手動呼叫 API 的情況下彙整與追蹤文書。
執行需求
透過 stdio 在本機執行,通常以 npx 從 npm 套件啟動,因此需要 Node.js 以及連線英國議會法定文書 API 的網路。未宣告驗證或 API 金鑰。README 範例設定使用 UPSTREAM_BASE_URL 與 REQUEST_TIMEOUT_MS;選用 HTTP 模式使用 UKP_HTTP_PORT。
安裝前請注意
所列工具都是對公開議會 API 的唯讀查詢,不會寫入或刪除資料。查詢與 ID 會送往上游英國議會 API,且 UPSTREAM_BASE_URL 可指向其他主機,除非確有必要,應維持官方位址。選用 HTTP 代理模式會開放本機連接埠並轉送任意上游路徑,需謹慎綁定位址並設定防火牆。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Uk Parliament Statutoryinstruments,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[MCP Compatible] [AI Agent Ready]

UK Parliament Statutory Instruments MCP Server

Summary

This MCP server provides structured access to UK Parliament Statutory Instruments data using the Model Context Protocol. It enables AI agents to query statutory instruments, procedures, laying bodies, and business items through API-backed tools and data access. Developers can integrate the MCP server via stdio transport to retrieve instruments across v1 and v2 endpoints. The server exposes tools that map directly to the Statutory Instruments API for reliable automation and AI agents workflows.

Features

  • Search statutory instruments and proposed negatives with filters for house, procedure, and status.
  • Retrieve instrument details, procedures, and business items by ID.
  • Access laying bodies and Acts of Parliament through v1 and v2 endpoints.
  • Preserve upstream payloads in a standardized envelope for downstream tools.

Available Tools

get_v1_business_item_by_id

Returns business item by ID.

Parameters:

  • id (string, path)
  • LaidPaper (string, query) – StatutoryInstrument | ProposedNegative

list_v1_laying_bodies

Returns all laying bodies.

list_v1_procedures

Returns all procedures.

get_v1_procedure_by_id

Returns procedure by ID.

Parameters:

  • id (string, path)

list_v1_proposed_negative_statutory_instruments

Returns a list of proposed negative statutory instruments.

Parameters:

  • Name (string, query)
  • RecommendedForProcedureChange (boolean, query)
  • DepartmentId (number, query)
  • LayingBodyId (string, query)
  • Skip (number, query)
  • Take (number, query)

get_v1_proposed_negative_statutory_instrument_by_id

Returns proposed negative statutory instrument by ID.

Parameters:

  • id (string, path)

list_v1_business_items_by_proposed_negative_statutory_instrument_id

Returns business items belonging to a proposed negative statutory instrument.

Parameters:

  • id (string, path)

list_v1_statutory_instruments

Returns a list of statutory instruments.

Parameters:

  • Name (string, query)
  • StatutoryInstrumentType (string, query) – DraftAffirmative | DraftNegative | MadeAffirmative | MadeNegative
  • ScheduledDebate (boolean, query)
  • MotionToStop (boolean, query)
  • ConcernsRaisedByCommittee (boolean, query)
  • ParliamentaryProcessConcluded (string, query) – NotConcluded | Concluded
  • DepartmentId (number, query)
  • LayingBodyId (string, query)
  • House (string, query) – Commons | Lords
  • Skip (number, query)
  • Take (number, query)

get_v1_statutory_instrument_by_id

Returns a statutory instrument by ID.

Parameters:

  • id (string, path)

list_v1_business_items_by_statutory_instrument_id

Returns business items belonging to statutory instrument with ID.

Parameters:

  • id (string, path)

list_v2_acts_of_parliament

Search through Acts of Parliament.

Parameters:

  • Id (array:string, query)
  • Name (string, query)

get_v2_act_of_parliament_by_id

Search individual Act of Parliament by ID.

Parameters:

  • id (string, path)

list_v2_statutory_instruments

Search through statutory instruments and proposed negatives.

Parameters:

  • Name (string, query)
  • Procedure (string, query)
  • ScheduledDebate (boolean, query)
  • MotionToStop (boolean, query)
  • ConcernsRaisedByCommittee (boolean, query)
  • ParliamentaryProcessConcluded (boolean, query)
  • DepartmentId (number, query)
  • LayingBodyId (string, query)
  • RecommendedForProcedureChange (boolean, query)
  • ActOfParliamentId (array:string, query)
  • House (string, query) – Commons | Lords
  • Skip (number, query)
  • Take (number, query)

get_v2_statutory_instrument_by_instrument_id

Get individual statutory instrument or proposed negative by id.

Parameters:

  • instrumentId (string, path)

list_v2_business_items_by_instrument_id

Get business items associated with a particular instrument.

Parameters:

  • instrumentId (string, path)

list_v2_business_items_by_timeline_id

Get business items associated with a particular timeline.

Parameters:

  • timelineId (string, path)

Example Output

json
{  "status": 200,  "data": {    "items": [      {        "instrumentId": "abcd1234",        "name": "Example Statutory Instrument",        "house": "Commons"      }    ],    "totalResults": 1  },  "upstream_path": "/api/v2/StatutoryInstrument",  "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-statutoryinstruments mcp-server-uk-parliament-statutoryinstruments

MCP Configuration

Example mcpServers configuration for stdio transport:

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

Example Usage

  • List statutory instruments laid in the Commons with a name filter.
  • Fetch a statutory instrument by ID and inspect its procedure.
  • Retrieve business items for an instrument or timeline.
  • Search Acts of Parliament linked to statutory instruments.

Use Cases

  • AI agents summarizing statutory instrument status and procedures.
  • Research tools tracking instruments by department or house.
  • Civic tech platforms monitoring proposed negatives and debates.
  • Automation workflows exporting instrument metadata for reporting.

Data Source

UK Parliament Statutory Instruments API https://statutoryinstruments-api.parliament.uk

Installation

Run directly using npx:

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

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

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

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

Published package command:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-statutoryinstruments -- mcp-server-uk-parliament-statutoryinstruments-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-statutoryinstruments -- 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/v2/StatutoryInstrument?House=Commons&Take=10"

License

MIT License

MCP Metadata

Protocol: Model Context Protocol Transport: stdio Tools: get_v1_business_item_by_id, list_v1_laying_bodies, list_v1_procedures, get_v1_procedure_by_id, list_v1_proposed_negative_statutory_instruments, get_v1_proposed_negative_statutory_instrument_by_id, list_v1_business_items_by_proposed_negative_statutory_instrument_id, list_v1_statutory_instruments, get_v1_statutory_instrument_by_id, list_v1_business_items_by_statutory_instrument_id, list_v2_acts_of_parliament, get_v2_act_of_parliament_by_id, list_v2_statutory_instruments, get_v2_statutory_instrument_by_instrument_id, list_v2_business_items_by_instrument_id, list_v2_business_items_by_timeline_id

來源:servers/uk-parliament-statutoryinstruments/README.md,提交 38e74c9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。