┌─────────────────────────────────────────────────────────────────────────────┐
│ 1. mantra-auth (:3000)                                                      │
│    Next.js OAuth 2.1 Authorization Server                                   │
│    • DB: postgres_auth (:5441 / mantra_auth_dev)                            │
│    • Issues HS256 JWT Tokens for Clients & Services                         │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │ Issues JWT Bearer Token
                                       ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ 2. MantraAssist-backend (:5500) [MCP CLIENT]                                │
│    Express.js / TypeScript Core Backend                                     │
│    • Computes doctor working hours from assist_db                           │
│    • Calls MCP tool over SSE / HTTP (/sse?token=...)                        │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │ Invokes `receive_doctor_availability`
                                       ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ 3. livekit-mcp (:8000) [THIS MCP SERVER]                                    │
│    Starlette + MCP 2.0 SSE Transport                                        │
│    • Auth Middleware: Validates HS256 JWT                                   │
│    • Timezone Resolver: Detects caller timezone from phone number           │
│    • Formatter: Normalizes UTC slots ➔ Caller's localized 12-hour format    │
│    • Public Endpoints: /health, /                                           │
│    • Protected Endpoints: /sse, /messages, /api/tools/call                  │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │ Real-time Tool Result
                                       ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ 4. lkt (:8081) [VOICE TELEPHONY AGENT]                                      │
│    MantraCare LiveKit Voice Telephony Engine                                │
│    • STT ➔ LLM ➔ TTS Voice Pipeline                                         │
│    • Calls check_doctor_availability dynamically mid-call                   │
│    • Speaks localized doctor times naturally to the caller                  │
└─────────────────────────────────────────────────────────────────────────────┘

livekit-mcp/
├── .env.example                # Sample environment variables
├── .gitignore                  # Git ignore definitions
├── .python-version             # Python version pin (3.11)
├── AGENTS.md                   # Agent Memory instructions
├── dev.sh                      # Development startup script
├── pyproject.toml              # UV package specification & build settings
├── uv.lock                     # Deterministic lockfile
├── README.md                   # Project documentation
│
├── obsidian/                   # Permanent Agentic Knowledge Base
│   ├── Home.md                 # Project navigation hub
│   ├── Architecture/           # System design, data flow, security & APIs
│   ├── Context/                # Stack, project summary & repository map
│   ├── Development/            # Sprint tracking, TODO & Changelog
│   ├── Features/               # Feature specifications (tools, auth)
│   └── Knowledge/              # Coding standards & conventions
│
├── scripts/
│   └── generate_token.py       # CLI utility to generate signed JWT tokens
│
└── src/
    └── livekit_mcp/
        ├── __init__.py
        ├── config.py           # Pydantic Settings & environment validation
        ├── server.py           # MCPServer & Starlette app factory
        ├── main.py             # CLI runner with Uvicorn
        ├── auth/
        │   ├── __init__.py
        │   ├── jwt.py          # HS256 JWT decoding & claims validation
        │   └── middleware.py   # Pure ASGI auth middleware (headers & ?token=)
        ├── clients/
        │   ├── __init__.py
        │   ├── db_client.py    # Async PostgreSQL pool (asyncpg)
        │   ├── lkt_client.py   # Async HTTP client for lkt (:8081)
        │   └── auth_client.py  # Async HTTP client for mantra-auth (:3000)
        ├── utils/
        │   ├── __init__.py
        │   └── timezone.py     # Phone number timezone auto-detection & UTC converter
        └── tools/
            ├── __init__.py
            ├── greeting.py     # `greet_user` health test tool
            ├── providers.py    # `search_provider_availability` direct DB search
            └── doctor_availability.py # `receive_doctor_availability` receiver tool

cd ~/livekit-mcp
cp .env.example .env
uv sync

uv run python scripts/generate_token.py --hours 72

./dev.sh

{
  "org_id": 66,
  "date": "2026-08-25",
  "caller_phone": "+12025550123",
  "providers": [
    {
      "user_id": 12,
      "name": "Dr. Ananya Sharma",
      "available_slots": [
        "14:00 - 15:00",
        "16:00 - 17:00"
      ]
    },
    {
      "user_id": 15,
      "name": "Dr. Rajesh Kumar",
      "available_slots": [
        "15:00 - 16:00",
        "17:00 - 18:00"
      ]
    }
  ]
}

📅 Available Doctors on Tuesday, Aug 25, 2026 (Local Timezone: America/New_York):

1. Dr. Ananya Sharma (User ID: 12)
   • Available Slots: 10:00 AM – 11:00 AM EDT, 12:00 PM – 1:00 PM EDT

2. Dr. Rajesh Kumar (User ID: 15)
   • Available Slots: 11:00 AM – 12:00 PM EDT, 1:00 PM – 2:00 PM EDT

Org ID: 66 | Caller Phone: +12025550123

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(
  new URL(`http://localhost:8000/sse?token=${process.env.MCP_JWT_TOKEN}`)
);
const client = new Client({ name: "mantra-backend", version: "1.0.0" }, { capabilities: {} });
await client.connect(transport);

const result = await client.callTool({
  name: "receive_doctor_availability",
  arguments: { ... }
});