Zava Insurance Server

An MCP (Model Context Protocol) server for Zava Insurance that exposes claims management tools and rich interactive widgets for ChatGPT.

Tech Stack

Layer	Technology
Protocol	MCP SDK (@modelcontextprotocol/sdk) — low-level Server class
Transport	Express + StreamableHTTPServerTransport (stateless, JSON response)
Database	Azure Table Storage (@azure/data-tables) via Azurite local emulator
Widgets	React 18 + Fluent UI v9 + Vite (single-file HTML builds)
Theme	Reactive dark/light via useSyncExternalStore + openai:set_globals event
Language	TypeScript throughout

Tools

Widget Tools (render interactive UI)

Tool	Description
show-claims-dashboard	Grid view of all claims with status filters, metrics, and click-to-detail
show-claim-detail	Detailed view of a single claim with inspections, POs, and a map
show-contractors	Filterable list of contractors with ratings and specialties

Data Tools

Tool	Description
update-claim-status	Update a claim's status and add notes
update-inspection	Update inspection status, findings, and recommended actions
update-purchase-order	Update a purchase order's status
get-claim-summary	Text summary of a specific claim
list-inspectors	List all inspectors with specializations

Quick Start

# 1. Install dependencies
npm install

# 2. Start Azurite (local storage emulator)
azurite-table --silent &

# 3. Seed the database
npm run seed

# 4. Build widgets
npm run build:widgets

# 5. Start the MCP server (port 3001)
cd server & npm run dev

Connect ChatGPT to: http://localhost:3001/mcp

Sample Prompts

Prompt	What it does
Show me all insurance claims	Opens the claims dashboard widget
Show claims that are pending	Dashboard filtered to pending claims
Show me claim CN202504990	Opens the detail view for that claim
Approve claim 3 and add a note "Verified by adjuster"	Updates claim status via update-claim-status
Show me all contractors	Opens the contractors list widget
Show only preferred roofing contractors	Filtered contractors list
Mark inspection insp-005 as completed with findings "No structural damage found"	Updates inspection
Approve purchase order po-003	Updates PO status
Give me a summary of claim 7	Returns a text summary
List all inspectors	Shows inspectors and their specializations

Project Structure

├── server/src/mcp-server.ts   # MCP server (tools, resources, transport)
├── server/src/database.ts     # Azure Table Storage data layer
├── widgets/src/
│   ├── claims-dashboard/      # Master-detail claims widget
│   ├── claim-detail/          # Standalone claim detail widget
│   ├── contractors-list/      # Contractors list widget
│   └── hooks/                 # Shared hooks (useOpenAiGlobal, useThemeColors)
├── assets/                    # Built single-file HTML widgets
└── db/                        # Seed data (JSON)