{
  "openapi": "3.1.0",
  "info": {
    "title": "RT Tours Discovery API",
    "version": "2026-04-19",
    "description": "Read-only machine-readable discovery surface for RT Tours VIP Israel. This specification documents public discovery endpoints and constraints. It does not represent a public self-serve booking API."
  },
  "servers": [
    {
      "url": "https://booking.rttours.co.il",
      "description": "Transitional discovery host"
    },
    {
      "url": "https://rttours.co.il",
      "description": "Canonical business host"
    }
  ],
  "tags": [
    {
      "name": "Discovery",
      "description": "Read-only service and machine-readable discovery endpoints"
    }
  ],
  "paths": {
    "/status.json": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getDiscoveryStatus",
        "summary": "Get public service discovery status",
        "responses": {
          "200": {
            "description": "Current public discovery status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Status"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getLlmsText",
        "summary": "Get AI-agent guidance in plain text",
        "responses": {
          "200": {
            "description": "Plain-text guidance for LLMs and agents",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/index.md": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getMarkdownHomepage",
        "summary": "Get the markdown homepage",
        "responses": {
          "200": {
            "description": "Markdown summary of RT Tours discovery information",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/ai-plugin.json": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getAiPluginManifest",
        "summary": "Get the OpenAI-style plugin manifest",
        "responses": {
          "200": {
            "description": "Plugin manifest",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AiPluginManifest"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getMcpDiscovery",
        "summary": "Get MCP discovery metadata",
        "responses": {
          "200": {
            "description": "MCP discovery information",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpDiscovery"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Status": {
        "type": "object",
        "required": ["name", "status", "canonicalHost", "transitionalHost"],
        "properties": {
          "name": { "type": "string" },
          "status": { "type": "string" },
          "canonicalHost": { "type": "string", "format": "uri" },
          "transitionalHost": { "type": "string", "format": "uri" },
          "publicCapabilities": {
            "type": "array",
            "items": { "type": "string" }
          },
          "publicConstraints": {
            "type": "array",
            "items": { "type": "string" }
          }
        }
      },
      "AiPluginManifest": {
        "type": "object",
        "required": ["schema_version", "name_for_human", "name_for_model", "description_for_model"],
        "properties": {
          "schema_version": { "type": "string" },
          "name_for_human": { "type": "string" },
          "name_for_model": { "type": "string" },
          "description_for_model": { "type": "string" }
        }
      },
      "McpDiscovery": {
        "type": "object",
        "required": ["name", "serverUrl", "serverCardUrl", "manifestUrl"],
        "properties": {
          "name": { "type": "string" },
          "serverUrl": { "type": "string", "format": "uri" },
          "serverCardUrl": { "type": "string", "format": "uri" },
          "manifestUrl": { "type": "string", "format": "uri" },
          "transport": { "type": "string" }
        }
      }
    }
  }
}