open-parliament-mcp

A thin MCP connector to the UK Parliament's public APIs and the Members OData endpoint. It exposes five generic tools rather than modelling endpoints; the "how to use each source" knowledge lives in playbooks.

Tools

• list_apis — list the available Parliament data sources.

• describe_api(api, detail?, path?) — show a source's endpoints (compact by default; detail:"full" for the raw spec; path to filter). For the OData source, lists collections / returns $metadata.

• call_api(api, path, query?) — GET an endpoint and return JSON. The host is fixed by the source id (allowlist); read-only.

• list_playbooks / get_playbook(name) — procedural advice.

Related MCP server: openproject-mcp

Running

npm install
npm run build
# stdio (Claude Desktop / Claude Code):
MCP_TRANSPORT=stdio node build/index.js
# streamable HTTP (default), port 3401:
node build/index.js

Configuration

Playbooks are fetched live from the playbooks/ folder of PLAYBOOKS_REPO, falling back to the copy bundled in the image when GitHub is unreachable.

Data sources

UK Parliament public APIs (read-only, no key required). See list_apis for the full set. This connector is unaffiliated with UK Parliament; cite results against the originating API.