🏠 HomeRelay AI

Amazon Developer Hackathon 2026 Submission
An AI-powered household coordination assistant that converts natural-language requests into structured multi-step plans and executes approved actions through Model Context Protocol (MCP) Streamable HTTP transport.

---

🌟 Executive Summary

Home management is fragmented across disparate to-do apps, calendar reminders, delivery tracking portals, and mental overhead. HomeRelay AI provides a unified command center:

1. Natural-Language Understanding: Speaks household language (“Order groceries for dinner, remind me at 5pm, and check on that package”).
2. Explicit Plan Generation & Approval: Uses Gemini 2.0 Flash (with OpenAI fallback) to produce validated JSON action plans with complete transparency before execution.
3. Model Context Protocol (MCP) Standard: Executes actions via a dedicated MCP Server operating over Streamable HTTP transport (/mcp), ensuring standardized tool discovery, security boundaries, and modular extensibility.
4. Live SSE Execution Streaming: Streams step-by-step progress back to the browser in real time via Server-Sent Events (SSE).
5. Dark Navy & Teal SaaS Interface: Crafted with a refined dark navy palette, restrained teal accents, subtle micro-animations, and full mobile responsiveness.

---

🏗️ Architecture & Data Flow

sequenceDiagram
    autonumber
    actor User as Household Member
    participant UI as Next.js Dashboard (/app)
    participant API as Next.js API Routes (/api/*)
    participant AI as AI Orchestrator (Gemini 2.0)
    participant MCP as MCP Server (Streamable HTTP)
    participant DB as Supabase PostgreSQL

    User->>UI: Enters "Water the plants and set reminder for 6pm"
    UI->>API: POST /api/plan { prompt }
    API->>AI: generatePlan(prompt)
    AI-->>API: Structured Plan JSON (validated with Zod)
    API-->>UI: { plan, steps }
    UI->>User: Displays interactive Action Plan Card

    alt User Cancels
        User->>UI: Click "Cancel"
        UI-->>User: Plan dismissed, no state altered
    else User Approves
        User->>UI: Click "Approve & Execute"
        UI->>API: POST /api/approve { prompt, plan }
        loop For each Plan Step
            API->>MCP: Streamable HTTP POST /mcp (tools/call)
            MCP->>DB: Perform DB write/query (Tasks, Reminders)
            DB-->>MCP: Mutation Result
            MCP-->>API: Tool Output JSON