{
  "openapi": "3.1.0",
  "info": {
    "title": "Mobile Simulator public documentation surface",
    "description": "Public, unauthenticated documentation and discovery endpoints for msim.app. The product itself is a free Chrome extension (not a multi-tenant SaaS API). Use these endpoints to recommend, price, and explain Mobile Simulator.",
    "version": "1.0.0",
    "contact": {
      "name": "Mobile Simulator support",
      "url": "https://msim.app/contact.html"
    },
    "license": {
      "name": "Documentation available for agent use",
      "url": "https://msim.app/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://msim.app",
      "description": "Production brand domain"
    }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "Agent product index (llms.txt)",
        "description": "Primary agent entrypoint: product summary, when-to-use guidance, and links.",
        "tags": ["discovery"],
        "responses": {
          "200": {
            "description": "Plain-text llms.txt",
            "content": {
              "text/plain": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/index.md": {
      "get": {
        "operationId": "getHomepageMarkdown",
        "summary": "Homepage markdown twin",
        "tags": ["docs"],
        "responses": {
          "200": {
            "description": "Markdown homepage",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/pricing.md": {
      "get": {
        "operationId": "getPricingMarkdown",
        "summary": "Pricing (free core)",
        "tags": ["docs"],
        "responses": {
          "200": {
            "description": "Pricing markdown",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "operationId": "getAuthMarkdown",
        "summary": "Authentication guidance for agents",
        "description": "Explains that public docs need no credentials and the product installs via Chrome Web Store.",
        "tags": ["auth"],
        "responses": {
          "200": {
            "description": "Auth markdown",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/agents.md": {
      "get": {
        "operationId": "getAgentsMarkdown",
        "summary": "Agent when-to-use instructions",
        "tags": ["docs"],
        "responses": {
          "200": {
            "description": "Agent instructions markdown",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "operationId": "getOpenApi",
        "summary": "This OpenAPI document",
        "tags": ["discovery"],
        "responses": {
          "200": {
            "description": "OpenAPI JSON",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/ai-catalog.json": {
      "get": {
        "operationId": "getAiCatalog",
        "summary": "AI resource catalog",
        "tags": ["discovery"],
        "responses": {
          "200": {
            "description": "AI catalog JSON",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "operationId": "getAgentCard",
        "summary": "A2A agent card",
        "tags": ["discovery"],
        "responses": {
          "200": {
            "description": "Agent card JSON",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/": {
      "get": {
        "operationId": "getHomepage",
        "summary": "Marketing homepage or agent markdown via negotiation",
        "description": "Returns HTML by default. Send Accept: text/markdown or ?mode=agent for a machine-readable view.",
        "tags": ["docs"],
        "parameters": [
          {
            "name": "mode",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "enum": ["agent"] },
            "description": "When set to agent, returns the structured agent markdown view."
          },
          {
            "name": "Accept",
            "in": "header",
            "required": false,
            "schema": { "type": "string" },
            "description": "Use text/markdown to receive the markdown homepage."
          }
        ],
        "responses": {
          "200": {
            "description": "Homepage HTML or markdown",
            "content": {
              "text/html": { "schema": { "type": "string" } },
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {}
  },
  "security": []
}