🛡️ PulseGuard MCP

Ambient Proactive Healthcare & Emergency Copilot for Alexa+ via Model Context Protocol (MCP)
Developed for the Amazon Developer Hackathon: Build, Ship, Shape 2026
Primary Track: Alexa+ · Mini-Challenges: AWS Builder & Open Source · Bonus Category: Friction Log

📌 Overview

Traditional smart home voice assistants are purely passive: they only respond when spoken to. If an elderly person living alone experiences a hard fall, sudden cardiac tachycardia, or misses life-saving heart medication, a passive assistant does nothing.

PulseGuard MCP changes this paradigm by turning the Echo Show 15, Ring Video Doorbell, and smart home actuators into an autonomous, proactive clinical guardian.

Powered by Amazon Bedrock (Nova Pro / Claude) and implementing the open Model Context Protocol (MCP), PulseGuard continuously monitors vital signs, reasons through clinical emergencies, coordinates perimeter security (auto-unlocking Ring deadbolts for EMTs), and maintains an immutable cloud care ledger on Amazon DynamoDB.

Related MCP server: Tend

🏗️ Architecture

flowchart TD
    subgraph Wearable_And_Perimeter["Ambient Sensors & Smart Home"]
        V["Wearable Telemetry<br/>(Heart Rate, Fall G-Force, Posture)"]
        P["Smart Pill Dispenser<br/>(Adherence Sensors)"]
        R["Ring Video Doorbell & Smart Deadbolt<br/>(Perimeter Access)"]
    end

    subgraph MCP_Layer["Model Context Protocol (MCP) Server"]
        MCP["PulseGuard MCP Server<br/>(SSE: /mcp/sse)"]
        T1["get_patient_vitals_telemetry"]
        T2["check_medication_adherence"]
        T3["control_ring_security"]
        T4["dispatch_emergency_escalation"]
        T5["record_care_event_log"]
        MCP --> T1 & T2 & T3 & T4 & T5
    end

    subgraph Agent_Core["Alexa+ Intelligence Layer"]
        Bedrock["Amazon Bedrock (Nova Pro / Claude 3.5)<br/>Autonomous Reasoning Loop"]
    end

    subgraph User_Interface["Echo Show 15 & Caregiver Command Center"]
        Echo["Echo Show 15 Smart Display<br/>(Web Speech Voice & Triage Cards)"]
        Console["Developer MCP Reasoning Inspector<br/>(Live Thought Tree & Tool Traces)"]
        Ledger["Amazon DynamoDB Care Ledger<br/>(SBAR Clinical Audit Handoff)"]
    end

    V & P & R <--> MCP
    MCP <--> Bedrock
    Bedrock <--> Echo & Console & Ledger

🧰 Registered Model Context Protocol (MCP) Tools

PulseGuard exposes 5 standardized MCP tools available over Server-Sent Events (/mcp/sse) and JSON-RPC:

⚡ Quickstart & Local Setup

Prerequisites

• Node.js: v18.0.0 or higher (Tested on Node v24)

• npm: v9.0.0 or higher

Installation & Launch

# 1. Clone repository
git clone https://github.com/your-username/pulseguard-mcp.git
cd pulseguard-mcp

# 2. Install dependencies
npm install

# 3. Start development server (both Backend MCP Server + Frontend Simulator)
npm run dev

• Frontend Alexa+ Simulator: http://localhost:3000

• Backend MCP API & Tools: http://localhost:3001/api/mcp/tools

• MCP SSE Endpoint: http://localhost:3001/mcp/sse

Note on AWS Credentials: PulseGuard includes a High-Fidelity Autonomous Engine that runs out of the box with zero configuration! If you wish to connect to live AWS Bedrock, copy .env.example to .env and provide your AWS keys.

🎬 4 Interactive Demo Scenarios

The simulator includes a 1-click Scenario Controller built specifically for judge evaluations and video demonstrations:

1. 🚨 Scenario 1: Critical Fall with Tachycardia

   • Wearable registers 3.85G impact fall in hallway; heart rate spikes to 142 bpm.

   • Alexa+ queries vitals via MCP -> detects post-impact immobility -> stages EMT handoff -> unlocks Ring Deadbolt -> initiates calm voice triage.

2. 💊 Scenario 2: Missed Anticoagulant (Eliquis)

   • Smart dispenser detects slot 3 is 140 min overdue.

   • Alexa+ queries adherence, cross-references elevated blood pressure (148/94), illuminates slot 3 on Echo Show, and speaks a proactive voice reminder.

3. 🚪 Scenario 3: Paramedics at Ring Video Doorbell

   • Ring Doorbell Pro verifies first responders.

   • Alexa+ broadcasts clearance instructions over Ring Intercom and displays live porch video on the smart display.

4. 🟢 Scenario 4: Baseline Normal & Scheduled Wellness Audit

   • Routine scheduled check-in verifying vitals, locking deadbolts, and updating the daily caregiver digest.

📝 Developer Friction Log (+10% Bonus Points)

As encouraged by Amazon Developer hackathon rules, we documented our engineering experience integrating Amazon Bedrock Converse API with the open Model Context Protocol.

👉 Read the full report: FRICTION_LOG.md

Key entries include:

• Entry 1: Resolving JSON-Schema Draft 7 validation rejections in Bedrock Converse tool definitions.

• Entry 2: Normalizing multi-turn tool result serialization with nested boolean flags.

• Entry 3: Bridging proactive push events into local Alexa+ agent simulations.

• Entry 4: Ring Video Doorbell sandbox and virtual access code staging.

• Entry 5: Multi-step MCP latency optimization via parallelized tool execution.

📄 Submission Documents

• DEVPOST_SUBMISSION.md: Full copy-paste project description, architecture overview, and challenge write-ups.

• DEMO_VIDEO_SCRIPT.md: Exact 2-minute 30-second scene-by-scene script for recording your video demo.

⚖️ License

Distributed under the MIT License. See LICENSE for details.