# 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`