Insurance MCP server scaffold (FastMCP 3.2 + Prefab-style UI payloads)

This scaffold implements an AI-agent backend for insurance recommendation with:

• Contract recommendation tool

• Horizontal carousel UI payload for contract cards

• Structured contract draft generation

• Validation for missing or invalid user data

• Electronic signature workflow with human approval

• Persist signed JSON contract to database

Important assumption The request mentioned Prefab integration for beautiful UI. Because the exact Prefab SDK / component contract is not specified here, the scaffold uses a Prefab adapter interface + generic UI JSON schema that your frontend/agent host can map to Prefab components.

Tools included

1. recommend_contracts

2. validate_profile

3. generate_contract_draft

4. request_missing_fields

5. submit_signature_for_approval

6. approve_and_persist_contract

Related MCP server: agent-insurance-mcp-server

Suggested architecture

Agent / Copilot / Chat UI
        |
        v
FastMCP Server
  - Recommendation Engine
  - Profile Validator
  - Draft Generator
  - Signature Workflow
  - Prefab UI Adapter
        |
        +--> SQLite / SQL Server / Postgres
        |
        +--> Human approval queue

Run

python -m venv .venv
source .venv/bin/activate
pip install -e .
python -m app.server

Notes about FastMCP 3.2

The exact import path / decorator names can differ slightly by installation packaging. If your environment exposes a different API surface, update the import in app/server.py and keep the tool function signatures + return shapes unchanged.