# Kindred

**Alexa+ household copilot for families who do not share the same clock.**

Kindred is a working Alexa+ experience for the [Build, Ship, Shape: Amazon Developer Hackathon](https://amazonappdev2026.devpost.com/). It is a self-hosted **MCP server on Streamable HTTP, spec `2025-11-25`**, plus a living-room Show simulator that is a real MCP client — it sends `initialize`, `tools/list`, and `tools/call`. That is the simulated Alexa+ path Amazon documents for this hackathon.

Open source · MIT · primary track **Alexa+** · mini challenge **Open Source**

## Why it exists

Ama is a nurse on nights. Jean works from the kitchen table. Maya and Eli are on school time. When Ama is asleep at noon, the house is still loud: doorbell, TV, lunch, pickup logistics. Group chats do not hold a doorbell. Calendars do not tell a twelve-year-old to keep the hallway quiet.

Kindred puts one **now** on the living-room display:

- Quiet hours that hold the door and send nudges to phones, not the speaker
- School run, meals, and chores on the same surface
- A wake briefing for the person who just got home — dinner, open work, and whether they still overlap with the kids

## Run it

```bash
npm install
npm run dev
```

Then open [http://localhost:3000](http://localhost:3000) and launch the Show at `/device`.

No API keys. Judges can click the suggestion chips in order and watch the MCP inspector on the right.

## MCP

| | |
| --- | --- |
| Endpoint | `POST /api/mcp` |
| Protocol | `2025-11-25` |
| Transport | Streamable HTTP |
| Session | `MCP-Session-Id` on initialize, required after that |
| GET SSE | `405` (allowed by the spec) |
| Agent Skill | [`skills/kindred-household/SKILL.md`](skills/kindred-household/SKILL.md) |

Headers the client sends:

- `Accept: application/json, text/event-stream`
- `MCP-Protocol-Version: 2025-11-25`
- `MCP-Session-Id` after initialize

Tools: `get_household_briefing`, `list_family_members`, `set_quiet_hours`, `plan_meal`, `assign_chore`, `complete_chore`, `add_calendar_event`, `send_family_nudge`, `wake_briefing`.

## Demo script (under 3 minutes)

1. Open `/device`. The Show initializes MCP and briefs the house.
2. “Quiet hours until 3pm, Ama is sleeping after night shift.”
3. “Nudge Jean to pick up Eli.” Watch it go to the phone because quiet hours are on.
4. “Plan dinner spaghetti.”
5. “Assign dishes to Maya.”
6. “Brief Ama for when she wakes.”

## Submission notes

- Track: Alexa+
- Mini challenge: Open Source (this repo, MIT `LICENSE`)
- Product feedback: [`FEEDBACK.md`](FEEDBACK.md)
- Friction log: [`FRICTION.md`](FRICTION.md)
- Devpost copy: [`SUBMISSION.md`](SUBMISSION.md)