openapi: 3.1.0
info:
  title: KeepFamilySafe Public API
  description: >
    Public, read-only interfaces for the KeepFamilySafe Family Safety app. These endpoints help
    developers and AI agents answer questions about KeepFamilySafe features, safe zones, SOS alerts,
    location sharing, platforms, downloads, privacy, and support.
  version: 1.0.0
  contact:
    name: KeepFamilySafe Support
    email: sganeshkumar654@gmail.com
servers:
  - url: https://keepfamilysafe-familysafety.web.app
paths:
  /.well-known/mcp:
    get:
      summary: MCP server discovery handshake
      description: Returns the Model Context Protocol server manifest for KeepFamilySafe.
      responses:
        "200":
          description: MCP server manifest (mcpServers).
          content:
            application/json:
              schema:
                type: object
    post:
      summary: MCP JSON-RPC endpoint (Streamable HTTP)
      description: >
        Accepts Model Context Protocol JSON-RPC messages (initialize, tools/list, tools/call).
        Single-response mode returns application/json.
      responses:
        "200":
          description: JSON-RPC response.
          content:
            application/json:
              schema:
                type: object
        "202":
          description: Accepted notification or client response.
        "400":
          description: Invalid JSON-RPC message.
  /mcp:
    post:
      summary: MCP JSON-RPC endpoint (alias)
      description: Alternate path for Model Context Protocol JSON-RPC messages.
      responses:
        "200":
          description: JSON-RPC response.
          content:
            application/json:
              schema:
                type: object