openapi: 3.1.0
info:
  title: PlatPhorm Starphone API
  version: 0.3.0
  description: Starphone product and platform discovery endpoints.
servers:
  - url: https://starphone.platphormnews.com
paths:
  /api/health:
    get:
      summary: Health check
      operationId: getHealth
      responses:
        '200':
          description: Service health
  /api/v1/health:
    get:
      summary: Versioned health check
      operationId: getHealthV1
      responses:
        '200':
          description: Service health
  /api/docs:
    get:
      summary: Public API docs payload
      operationId: getDocs
      responses:
        '200':
          description: Public docs
  /api/mcp:
    get:
      summary: MCP discovery metadata
      operationId: getMcpMetadata
      responses:
        '200':
          description: MCP discoverability metadata
    post:
      summary: MCP JSON-RPC control
      operationId: postMcp
      responses:
        '200':
          description: JSON-RPC 2.0 response
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: PLATPHORM_API_KEY
      description: "Authorization: Bearer $PLATPHORM_API_KEY"
    xPlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
      description: "X-PlatPhorm-API-Key: $PLATPHORM_API_KEY"