{
  "openapi": "3.1.0",
  "info": {
    "title": "Property Evaluator API",
    "version": "1.1.0",
    "description": "Public property-evaluation MCP and discovery surfaces plus protected product workflows."
  },
  "servers": [{ "url": "https://zillow.platphormnews.com" }],
  "components": {
    "securitySchemes": {
      "platformBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "PLATPHORM_API_KEY" },
      "platformHeader": { "type": "apiKey", "in": "header", "name": "X-PlatPhorm-API-Key" }
    }
  },
  "paths": {
    "/api/health": { "get": { "summary": "Read live service and Aurora health", "responses": { "200": { "description": "Operational" }, "503": { "description": "Degraded" } } } },
    "/api/docs": { "get": { "summary": "Read API documentation", "responses": { "200": { "description": "Documentation" } } } },
    "/api/mcp": {
      "get": { "summary": "Read MCP metadata", "responses": { "200": { "description": "MCP metadata" } } },
      "post": { "summary": "Execute public read-only MCP JSON-RPC methods", "responses": { "200": { "description": "JSON-RPC response" }, "204": { "description": "JSON-RPC notification accepted" } } }
    },
    "/api/db/test": { "get": { "summary": "Verify the protected Aurora connection", "security": [{ "platformBearer": [] }, { "platformHeader": [] }], "responses": { "200": { "description": "Aurora connected" }, "401": { "description": "Authentication required" }, "503": { "description": "Aurora unavailable" } } } }
  }
}