Docs

Read the source.

We host the docs on GitHub so they version with the code. Pick a starting point:

API reference

Every REST endpoint, request/response schema, and example curl. Auto-generated from the OpenAPI spec.

Architecture

Multi-tenancy model, storage backend, queue, the MCP ↔ REST relationship, what's where in the repo.

Self-hosting

Run the whole stack locally with docker-compose, or deploy to Fly.io with fly.toml + scripts/deploy.sh.

Claude Desktop setup

Point Claude at the MCP server. Five-line config; works on Windows, macOS, Linux.

Quickstart

# Clone + install
git clone https://github.com/squareonestudio/millwork-mcp
cd millwork-mcp
pip install -e ".[dev,webapp]"

# Seed demo data
python scripts/seed_demo_data.py --force

# Mode 1: MCP server (stdio for Claude Desktop)
python server.py

# Mode 2: REST API (FastAPI, multi-tenant)
SQONE_DEV_AUTH=1 squareone-api
# OpenAPI docs at http://localhost:8000/docs

# Mode 3: docker-compose (production-like)
cp .env.example .env
docker compose up -d --build