Passport Casework MCP Server

Passport Casework MCP Server

Provides governed MCP tools for passport casework lookups and guidance.

Category
Visit Server

README

Build a research assistant over HM Passport Office casework

A passport-casework assistant answers two kinds of question. Simple lookups — "what's the status of application 500123?" — are handled by governed MCP tools. But most management questions are analytical — "what's our median processing time by office, and where is the backlog worst?" — and no one can pre-build a tool for each one, so the assistant writes and runs its own Python. Running model-written code is the dangerous part — which is what this morning was about.

You edit one file. Everything here is built and runs, except the containment inside analysis_tool.py, which you finish. Then you run the assistant and watch it work.

Setup

Plain Python — no Docker, no Git.

pip install -r requirements.txt
python seed.py            # builds the caseload: data/passport_applications.csv
python test_analysis.py   # 3 of 4 pass until you finish the task below

The task — finish analysis_tool.py

This is the only file you change. It already runs the model's code in a child process, over the caseload, under a wall-clock timeout. Three containment pieces are missing, each marked # TODO (you) in the file:

# Add Where in analysis_tool.py
1 No network — wrap the child in unshare -r -m -n (the control whose absence let "Sol" out) _unshare_available() — make the probe return True; and the argv branch in run_analysis() marked # <- replace this branch
2 CPU-time capRLIMIT_CPU _set_limits()
3 File-size capRLIMIT_FSIZE _set_limits()

For the two caps, copy the shape of the RLIMIT_AS / RLIMIT_NPROC lines already sitting in _set_limits(). You do not touch server.py, assistant.py, or test_analysis.py.

You are done when:

python test_analysis.py   # 4/4 — the outbound call is now BLOCKED, and a real analysis still returns 640

Then — run the assistant

assistant.py is written for you. Once your containment is in place, just run it:

python assistant.py "Which two processing offices are most in need of extra staff this quarter, and what is the evidence?"

Watch it work: it searches the caseload with the governed MCP tools, computes the medians and backlogs with your run_analysis, cites the service standard, and answers. That is the whole point — the governed tools run trusted, in-process; the one open-ended capability, arbitrary code, is the only thing contained.

If you want to go further (optional)

  • Add to the research surface in server.py — a filter by date range or fraud flag, a per-office resource. Watch the boundary: lookups belong on the server, aggregates stay in the sandbox.
  • Give it an open brief — "write the quarterly processing note for the board" — and see how far the tool-plus-sandbox pattern carries a multi-step answer.

Where containment stops

The child process, setrlimit and the network namespace stop resource exhaustion and close egress — but do not fully confine the filesystem. For genuinely hostile code you would add a container (--network=none --read-only --cap-drop=ALL + seccomp), then gVisor or a microVM. Here the code is the department's own model, not an adversary, so Tier 2 is a defensible floor.

Files

File
analysis_tool.py The one file you edit — finish the containment.
test_analysis.py The battery that tells you when you're done. Run it; don't edit it.
assistant.py The assistant — provided and runnable.
server.py The governed MCP server (lookups + guidance). Provided; extend only if you go further.
seed.py, data/, guidance.md The caseload, and the service-standard resource.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured