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
      requestBody:
        required: true
        content:
          application/json:
            schema: { type: object }
      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 }