Pantrist MCP Server
A Model Context Protocol server that wraps the Pantrist REST API, so an LLM client (Claude Desktop, the Claude web/mobile connector, Cursor, …) can manage shopping lists, the pantry, recipes and the week plan in natural language.
It's a thin wrapper — no business logic. Every tool maps to an existing
REST endpoint and forwards the caller's Bearer token. The HTTP client is
generated from the public OpenAPI spec (src/generated/pantrist-api.ts),
so request/response types track the API automatically; only the curated tool
layer (src/tools.ts) is hand-written.
Documentation
- docs/ARCHITECTURE.md — components, the token context, request flow, transports, regeneration.
- docs/AUTHENTICATION.md — OAuth flow, token-type ↔ tool compatibility, multi-user isolation, the consent-page dependency.
- docs/DEPLOYMENT.md — full env var reference, remote/ingress setup, scaling, security checklist.
- docs/TOOLS.md — every tool's args, REST mapping, and the item shape.
- docs/LIMITATIONS.md — known rough edges (read before relying on it in production).
