Zava Insurance — MCP Server

An MCP (Model Context Protocol) server for Zava Insurance that exposes claims management tools and rich interactive widgets for Microsoft 365 Copilot declarative agents.

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

Note: Run all commands from the root mcpserver/ directory.

# 1. Install ALL dependencies (root + server + widgets)
#    This is required — each sub-project has its own package.json
npm run install:all

# 2. Start Azurite (local storage emulator) — run in a separate terminal
npm run start:azurite

# 3. Seed the database (requires Azurite to be running)
npm run seed

# 4. Build widgets
npm run build:widgets

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

The MCP server will be available at: http://localhost:3001/mcp

To learn how to connect this server to a declarative agent for Microsoft 365 Copilot, see Build declarative agents for Microsoft 365 Copilot with MCP.

Auto-deploy to Azure Container Apps

This repo includes a workflow at .github/workflows/containerapp-autodeploy.yml that automatically deploys on every push to main.

1) Configure GitHub Secrets

• AZURE_CREDENTIALS — service principal JSON for azure/login
• AZURE_STORAGE_CONNECTION_STRING — Azure Table Storage connection string

2) Configure GitHub Variables

• AZURE_RESOURCE_GROUP
• AZURE_LOCATION (for example: eastus)
• AZURE_CONTAINERAPPS_ENVIRONMENT
• AZURE_CONTAINER_APP_NAME
• AZURE_CONTAINER_REGISTRY (ACR name, globally unique)

3) Deploy

• Push to main (or run workflow manually via Actions → Deploy MCP Server to Azure Container Apps).
• The workflow builds Docker image, pushes to ACR, then creates/updates the Container App.
• After deployment, endpoint format is: https://<container-app-fqdn>/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)