Initial commit: Handoff Pro MCP server for Kellow Construction

README.md

@@ -0,0 +1,53 @@
+# Handoff Pro — Construction Project Management MCP Server
+
+MCP server extending Tom (Kellow Construction AI agent on GW-2) with estimation, proposals, invoicing, and project management — synced with JobTread + QuickBooks Online.
+
+## Architecture
+
+```
+Tom (Telegram) → mcporter → handoff-pro MCP (port 3101)
+                          → design-agent MCP (port 3100)
+                          ↓
+                    SQLite (local) ←→ JobTread API
+                                   ←→ QuickBooks Online API
+```
+
+## Quick Start
+
+```bash
+# Run tests
+cd handoff-pro && python3 -m pytest tests/
+
+# Run server locally
+python3 server.py
+
+# Deploy to GW-2
+chmod +x deploy.sh && ./deploy.sh
+
+# Or run as Docker container
+docker build -t handoff-pro .
+docker run -d --name handoff-pro -p 3101:3101 \
+  -v /path/to/.jobtread-api.json:/app/data/.jobtread-api.json:ro \
+  handoff-pro
+```
+
+## Tools (34 total)
+
+See `SKILL.md` for full tool reference and workflow patterns.
+
+## Dependencies
+
+- Python 3.10+ (stdlib only — no pip install needed)
+- SQLite3 (bundled with Python)
+- Network access to JobTread API and QBO token server
+
+## Deployment Options
+
+1. **In-container** (recommended): Deploy scripts directly into Tom's workspace via `deploy.sh`
+2. **Standalone Docker**: Run as separate container on TrueNAS, register in mcporter
+3. **Hybrid**: Scripts in workspace + server as sidecar container
+
+## Credentials
+
+- **JobTread**: `.jobtread-api.json` with `grantKey` and `organizationId`
+- **QBO**: Token server at `http://192.168.86.11:18801/kellow-tokens.json`