resume-admin MCP server

A small, local, stdio-based MCP server that wraps the admin sign-in API on resume.naplab.org, so you can ask Claude Code things like "who last signed in?" or "how many sign-ins in the past week?" without running curl by hand.

It's a thin client: each tool calls the deployed admin API over HTTPS and hands the JSON back to Claude. All read-only — no write tools, no summarization logic.

Tools

Related MCP server: Plausible MCP

Setup

cd ~/Documents/claude/resume-ai-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Configuration

Two environment variables are required; the server fails fast at startup if either is missing:

Register with Claude Code

Run the server through the venv's Python so the mcp/httpx deps are on the path (adjust the interpreter path if you didn't use .venv):

claude mcp add --transport stdio resume-admin \
  --env ADMIN_API_KEY=<your_admin_api_key> \
  --env ADMIN_API_BASE_URL=https://resume.naplab.org \
  -- ~/Documents/claude/resume-ai-mcp/.venv/bin/python ~/Documents/claude/resume-ai-mcp/server.py

If python on your PATH already has mcp and httpx installed, you can substitute -- python ~/Documents/claude/resume-ai-mcp/server.py instead.

Once registered, this config (including your real key) lives in a local Claude Code config file (~/.claude.json or a project .mcp.json) — do not commit it anywhere.

Errors

Failures come back as short messages, not stack traces — e.g. a bad key returns "Authentication failed — check ADMIN_API_KEY.", and a network problem returns a one-line reachability message. Requests time out after 10s. No retries.