Metadata-Version: 2.4
Name: tempo-mcp
Version: 0.1.1
Summary: Tempo — the founder-vitals MCP connector that joins human capacity to business load.
Project-URL: Homepage, https://temposolo.app
Project-URL: Issues, https://github.com/tsutera09/tempo-mcp/issues
Project-URL: Source, https://github.com/tsutera09/tempo-mcp
Author: Tempo Labs
License: MIT
Keywords: burnout,business,claude,mcp,solopreneur,wellbeing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == 'dev'
Description-Content-Type: text/markdown

# Tempo MCP

<!-- mcp-name: io.github.tsutera09/tempo -->

**The founder-vitals connector for solo operators.** Tempo is the first MCP server that joins *human capacity* (sleep, mood, stress, energy) to *business load* (meetings, revenue, deal flow) and exposes them to Claude as one signal.

For a solopreneur, the founder is the single point of failure. Every other tool treats the business and the human as separate things. Tempo fuses them, so Claude can make business decisions — decline meetings, reprice services, prescribe rest days — based on the founder's real-time state.

## What makes this novel

Tempo invents a single KPI that no other tool can compute on its own:

**Revenue per Recovery Hour (RpRH)** — revenue generated divided by hours of true recovery. Falling RpRH means you're working harder for less, and it's the earliest quantitative signal of founder burnout.

## Install

```bash
pip install tempo-mcp
```

## Register with Claude Desktop / Cowork / Claude Code

`~/.claude/settings.json` (or equivalent):

```json
{
  "mcpServers": {
    "tempo": {
      "command": "python",
      "args": ["-m", "tempo_mcp"]
    }
  }
}
```

## Tools exposed over MCP

| Tool | Purpose |
|------|---------|
| `log_checkin` | Log mood / energy / stress / sleep |
| `ingest_revenue_event` | Record revenue (from Stripe connector or manual) |
| `ingest_calendar_event` | Record a calendar block (internal, sales, deep work) |
| `tempo_score` | Compute the composite Tempo score + RpRH |
| `recommend_actions` | Prescriptive business moves based on current state |
| `apply_action` | Log (or, on Pro, execute) an action |
| `get_history` | Full time-series history over N days — for trend analysis |
| `weekly_digest` | Narrative week-over-week summary Claude can read aloud |

## Example conversation with Claude

> **You**: "I slept 5 hours, energy's at 3/10, stress 8. Log it and tell me what to do about tomorrow."
>
> **Claude** (using Tempo): *logs checkin → pulls score → RpRH down 22% → 4 external calls booked tomorrow → recommends auto-decline of 2 discovery calls and a rest day.*

## Data stays local

Tempo stores everything in `~/.tempo/tempo.sqlite3`. Nothing leaves your machine unless you enable the Pro cloud sync.

## Develop

```bash
git clone https://github.com/tsutera09/tempo-mcp
cd tempo-mcp
pip install -e '.[dev]'
pytest
python -m tempo_mcp   # runs the MCP server on stdio
```

## Publishing

See `PUBLISH.md` at the repo root for the ordered release checklist (PyPI, npm mirror, MCP registry).

## License

MIT
