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

# 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

In-container (recommended): Deploy scripts directly into Tom's workspace via deploy.sh
Standalone Docker: Run as separate container on TrueNAS, register in mcporter
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