Skip to content

Documentation

New here? Start with Getting started. It goes from nothing to your first question in about fifteen minutes, once Crunch has given you API access.

Guide What’s in it
Getting started Getting API access, running the container, logging in to Crunch, connecting Claude Code, first questions
Connecting MCP clients Claude Code, Claude Desktop, VS Code, Cursor, Codex, generic clients, stdio mode
Configuration Every environment variable, how login, scopes and tokens work, Docker secrets, choosing toolsets, example configs
Using crunch-mcp Example conversations, built-in prompts, how changes work, receipts and PDFs, lists and paging, the raw API tool
Tool reference Every tool and argument, generated from the code
Guide What’s in it
Deployment Compose, image tags, upgrades, reverse proxies with TLS, hardening, running without Docker
Security Threat model, layers of protection, token storage, recommended setups, checklist
Compatibility The Crunch public API, its limits, and what isn’t covered
Troubleshooting Error messages and how to fix them
Guide What’s in it
Contributing guide How to report issues, set up, and open pull requests
Development Architecture, adding a tool, the mock Crunch API, testing
Releasing Versioning, cutting a release, what the release workflow does
Changelog What changed in each version