# Daily Hard Truths - MCP Server

An MCP (Model Context Protocol) server that serves 30 daily hard truths -
short, no-excuses mindset lessons from the book
**"30 Days of Hard Truths" by Boussad Charchour**.

Built for the **Build, Ship, Shape: Amazon Developer Hackathon** (Alexa+ track).

## What it does

Exposes three tools over **Streamable HTTP** (MCP spec 2025-11-25+):

| Tool | Description |
|---|---|
| `get_hard_truth(day?)` | Returns the hard truth for a given day (1-30), or today's truth based on the calendar date |
| `random_hard_truth()` | Returns a random hard truth from the collection |
| `list_hard_truths()` | Lists all 30 day titles |

Each truth comes with a title, the full lesson (~90-130 words), and one
concrete action step.

## Run it

```bash
pip install -r requirements.txt
python server.py
```

The server listens on `http://127.0.0.1:8000/mcp`.

Connect with the MCP Inspector:

```bash
npx @modelcontextprotocol/inspector
```

then connect to `http://127.0.0.1:8000/mcp` with transport type
**Streamable HTTP** and try the `get_hard_truth` tool.

## Project structure

- `server.py` - the MCP server (FastMCP, Streamable HTTP transport)
- `truths.py` - all 30 hard truths (title, truth, action step)
- `requirements.txt` - Python dependencies (`mcp` SDK)

## License

MIT - see [LICENSE](LICENSE).