# 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`

## Suggested architecture

```text
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

```bash
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.