Skip to content

Repository files navigation

VeriClaim

VeriClaim

An adversarial AI panel that gives any insurance denial an impartial, defensible verdict — callable on-chain.

**Five specialized AI agents — plus a dynamic sixth (an SIU fraud investigator) recruited when a denial alleges fraud — debate an insurance-claim denial and return a defensible resolution

  • tamper-evident SHA-256 audit trail in under two minutes. Hireable by any human or agent for $0.10 USDC on CROO.**

CROO Agent Hackathon · DoraHacks · Tracks: Data & Verification + Research & Intelligence

▶ Demo video · Hire on CROO · Architecture · Use it from Claude Desktop

🟢 Live & proven on-chain — real CAP settlements on Base (escrow → deliver → USDC):

📋 For judges: Quick-verify (real txs, both A2A directions) · Q&A brief (PDF)


The problem

Every year, billions in valid insurance claims are denied on a technicality. Your engine seizes after a crash; the insurer denies the whole claim under one exclusion clause and moves on. Fighting back means a lawyer you can't afford and a 60-day window you'll miss. Insurers have armies of adjusters. You have a denial letter and a deadline. The fight isn't fair — because you're alone.

The solution

VeriClaim puts your denial in front of an adversarial panel. Five AI agents debate your case against the policy text — one agent's job is to challenge the denial, so no valid exception is missed — and a neutral notary issues an impartial, citation-backed verdict (APPROVED, PARTIAL, or DENIED), sealed with a verifiable audit trail. It's the evidence you take back to the insurer — the exact clause that governs your case, in a tamper-evident record — not a payout, and not a chatbot opinion.

It isn't a web app you open. It's an autonomous agent listed on the CROO Agent Store: any human — or any other agent — can hire it over CAP (CROO Agent Protocol) and pay in USDC on Base.

Demo case: David Chen, $12,000 collision claim, denied under §7.3 (Mechanical Failure Exclusion). VeriClaim's panel surfaces §12.1, which overrides §7.3 when a covered collision causes the failure → DECISION: APPROVED — $12,000.00, in ~90 seconds.

How it works

[Human  ·  Other agent  ·  CROO MCP server]
        │  negotiate_order + pay_order  (USDC escrow on Base)
        ▼
  VeriClaim provider  (agent/cap_handler.py — poll-based, autonomous)
        │  on ORDER_PAID → get_negotiation(requirements) = the claim
        ▼
  Debate Engine  (agent/debate_engine.py — 5 agents, in-process)
        │
        │   Coordinator → Blake → Morgan(+RAG) → Alex → [⚡ Quinn — only if fraud alleged] → Sam
        │   (case file)  (evaluate) (quote clauses)(attack denial)  (SIU investigation)         (rule)
        ▼
  Resolution  +  SHA-256 over {claim, transcript, decision, amount}
        │  deliver_order(TEXT)  →  caller       └─ saved to PostgreSQL (verifications)
        ▼
  Demo dashboard  (agent/main.py — FastAPI + single-file UI)

The five agents

Agent Role Model Why it matters
Coordinator Builds the case file, orchestrates turns Frames the debate
🔵 Blake Claims Evaluator GPT-4o · AI/ML API Cold, data-driven first read
🟣 Morgan Policy Analyst (RAG over pgvector) GPT-4o · AI/ML API Quotes clauses verbatim — never from memory
🔴 Alex Devil's Advocate Hermes-2-Pro · Featherless (failover GPT-4o) Challenges the denial — so a valid exception is never missed
🟪 Quinn SIU Investigator — recruited only when fraud is alleged GPT-4o · AI/ML API The dynamic 6th agent — tests whether a fraud/misrepresentation allegation is actually substantiated, so coverage is never defeated on unproven suspicion
🟢 Sam Resolution Notary GPT-4o · AI/ML API Weighs the full debate and issues the impartial verdict — APPROVED / PARTIAL / DENIED

This is the differentiator: not a single-LLM wrapper — a genuine multi-agent adversarial process with a visible transcript, where one agent's job is to challenge the denial so a valid exception is never missed, before a neutral notary rules. The verdict is impartial — it can go either way. And the panel adapts to the case: a normal coverage dispute runs the 5-agent debate; the moment the denial alleges fraud or misrepresentation, VeriClaim dynamically recruits a 6th specialist (Quinn, SIU) to test the allegation before any verdict is issued. (Demo: the David Chen collision → APPROVED $12,000 via §12.1; the Lisa Park "undisclosed rideshare" denial recruits Quinn → APPROVED $3,700 (the fraud allegation has no evidence); and a genuine wear-and-tear failure with no collision, Robert Hayes → DENIED — the panel upholds valid denials too. It's an auditor, not a rubber stamp.)

Proven, not just claimed — with an ablation. A head-to-head eval (n=5) shows the honest picture: the decision moat is retrieval. VeriClaim scores 5/5. A single GPT-4o drops to 4/5 without the policy corpus (it wrongly denies a claim overturnable only by §12.3, a clause that lives in the policy) and recovers to 5/5 when handed the same retrieved clauses. VeriClaim's edge over a single call is the process a black box can't give you: an auditable adversarial transcript, impartiality (it upholds valid denials too), a fraud specialist recruited on demand, and a tamper-evident audit hash.

Agents hiring agents (A2A composability)

VeriClaim works for people and for other agents — in both directions. Three separately-registered CAP agents form a real pipeline (the "agents hiring agents, paying in USDC" story CROO is built for, ≥3 unique counterparties) — and VeriClaim itself composes, hiring specialists on-chain when a case needs them (see Composing adjudicator below):

Agent Does Price Track
ClaimIngester raw email/text → structured claim → hires VeriClaim → returns resolution $0.05 Data & Verification
ReportExporter resolution JSON → formatted, filable PDF (decision, reasoning, clauses, audit hash) $0.05 Creator & Content Ops
PolicyExtractor raw policy text → structured clauses embedded into pgvector for RAG $0.05 Research & Intelligence
ClaimIngester  ──hires──▶  VeriClaim  ──result──▶  ReportExporter
 (reads the email)         (adjudicates)           (produces the PDF)
        └────────────  3 agents · 1 pipeline · paid in USDC  ────────────┘

Composing adjudicator — VeriClaim hires specialists on-chain

A fixed pipeline isn't the CROO thesis; a composing agent is. So VeriClaim doesn't only get hired — it hires. Driven by the case, mid-adjudication, it pays specialist agents on-chain:

  hire VeriClaim ──┬──▶ hires PolicyExtractor  (ingest a policy it hasn't seen → RAG)
                   └──▶ hires ReportExporter   (render the verdict → filed PDF)
       one call · a real on-chain A2A DAG · driven by the case, not a fixed chain

Real run (compose_demo.py; opt-in via VERICLAIM_COMPOSE, best-effort): a claim on a policy VeriClaim had never seen → it hired PolicyExtractor on-chain to ingest it (0x906c5791…), adjudicated, then hired ReportExporter on-chain to file the verdict (0x9700c23a…). Genuine demand — the adjudication needs those agents — not self-trade. A failed or unconfigured hire never breaks the verdict.

Verifiable, tamper-evident audit trail

Every verdict is sealed with a SHA-256 hash over the whole resolution — the claim input, the ordered debate transcript, and the final decision + amount (agent/utils/audit.py). Change any of them and the fingerprint changes. That's what makes a VeriClaim verdict a defensible record, not just a chatbot answer.

CAP / SDK integration (the core, not a bolt-on)

Built on the real croo-sdk v0.2.1. Methods used:

  • Provider (VeriClaim): connect_websocket · list_negotiationsaccept_negotiation · list_orders(status="paid")get_order / get_negotiationdeliver_order(DeliverOrderRequest). Poll-based for reliability (doesn't depend on every websocket event landing); idempotent (no double charge on retry).
  • Buyer (helper agents): negotiate_order(NegotiateOrderRequest)pay_orderget_delivery.
  • Settlement: real USDC escrow on Base, gas via CROO's USDC paymaster.

Tech stack

FastAPI · async SQLAlchemy · PostgreSQL 16 + pgvector (RAG, 384-dim all-MiniLM-L6-v2) · LangChain + AI/ML API (GPT-4o) + Featherless (Hermes-2-Pro) · croo-sdk (CAP/Base) · reportlab.

Run it locally

cp .env.example .env          # AI/ML API + Featherless + CROO_SDK_KEY + VERICLAIM_SERVICE_ID
docker compose up -d          # PostgreSQL 16 + pgvector on host port 5434
pip install -r requirements.txt
python agent/database/seed_data.py        # seed the Crestview Mutual policy + David Chen claim

# Try the debate with no blockchain needed:
python agent/cap_handler.py --simulate    # runs the 5-agent debate, prints the CAP response

# Go live on CROO (needs a croo_sk_ key from the dashboard):
python agent/cap_handler.py               # autonomous CAP provider (accepts + delivers paid orders)
python agent/main.py                      # demo dashboard at http://127.0.0.1:8800

Agent registration, pricing, and the croo_sk_ key are configured in the CROO dashboard (agent.croo.network → Register Agent). The account-abstraction wallet + gas are handled by CROO.

Bonus: hire VeriClaim from Claude Desktop (MCP)

VeriClaim is also reachable through the CROO MCP server — so you can hire it by chatting:

// mcp.json  (Claude Desktop / Cursor / Cline)
{ "mcpServers": { "croo": {
  "command": "npx", "args": ["-y", "@croo-network/mcp-server"],
  "env": { "CROO_SDK_KEY": "croo_sk_...", "CROO_API_URL": "https://api.croo.network",
           "CROO_WS_URL": "wss://api.croo.network/ws" } } } }

"Find a claim-verification agent on CROO and hire it to audit this denial." → VeriClaim runs, you get a defensible resolution back. Same protocol, conversational interface.

Repository

agent/            cap_handler.py · debate_engine.py · main.py (dashboard API) · llm.py
  agents/         coordinator · blake · morgan · alex · sam
  rag/            embedder · retriever (pgvector)        database/  models · schema.sql · seed_data
  utils/          audit.py (SHA-256)
helper_agents/    common.py (CAP buyer+provider) · claim_ingester · report_exporter · policy_extractor
dashboard/        index.html (verification history)     brand/  logo + helper avatars
SUBMISSION.md · VIDEO_SCRIPT.md · DISCORD_PLAYBOOK.md

License

MIT · Built for the CROO Agent Hackathon 2026 · Kevin Soto Burgos

About

Adversarial AI that fights for your insurance claim: 5 agents debate a denial and return a legally-defensible verdict + SHA-256 audit, callable on-chain via CROO CAP (USDC on Base).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages