API Documentation

Integrate the DFW Sewer Second Opinion decision engine into your own applications.

REST API

POST /api/v1/decision

Submit assessment data and receive a structured decision result.

curl -X POST /api/v1/decision \
  -H "Content-Type: application/json" \
  -d '{
    "situation": "contractor_full_replacement",
    "cameraInspectionDone": "yes",
    "cameraFindings": ["root_intrusion", "corrosion"],
    "footageShown": "yes",
    "locationIdentified": "yes",
    "recommendations": ["full_replacement"],
    "quoteRange": "10000_20000"
  }'

Response

{
  "decision_state": "INSUFFICIENT_EVIDENCE",
  "evidence_supporting": [...],
  "evidence_missing": [...],
  "questions_to_ask": [...],
  "options_to_discuss": [...],
  "next_steps": "...",
  "urgency": "low",
  "limitations": [...]
}

OpenAPI Specification

A complete OpenAPI 3.1 specification is available at:

/api/openapi.json

MCP (Model Context Protocol)

The decision engine is available as an MCP tool for AI agents at:

Remote MCP: /mcp

Tool Name

dfw_sewer_repair_replacement_decision

Discovery

/.well-known/mcp.json
/.well-known/ai-plugin.json
/llms.txt

Decision States

INSUFFICIENT_EVIDENCEInfo does not establish why major replacement is needed

REPAIR_REHAB_EVALUATIONTargeted alternatives worth discussing

PARTIAL_REPLACEMENT_INDICATORSLocalized structural problem warrants evaluating section replacement

STRONG_REPLACEMENT_INDICATORSMultiple evidence supports substantial/full replacement

URGENT_PROFESSIONAL_EVALUATIONImmediate professional attention needed