{
  "openapi": "3.1.0",
  "info": {
    "title": "MobileBuilds MCP Server Releases API",
    "version": "1.0.0",
    "description": "Release manifest for the MobileBuilds MCP Server, a Developer ID macOS app distributed outside the App Store. `GET /versions.json` returns the list of published server versions, newest first. MobileBuilds itself decodes this response and installs from it.",
    "contact": {
      "name": "Delightful Apps Pty Ltd support",
      "email": "support@mobilebuilds.app",
      "url": "https://helper.mobilebuilds.app"
    }
  },
  "servers": [
    {
      "url": "https://helper.mobilebuilds.app",
      "description": "Production"
    }
  ],
  "paths": {
    "/versions.json": {
      "get": {
        "summary": "List published MCP server releases",
        "description": "Returns every published MobileBuilds MCP Server version, ordered newest first. Order is not significant: clients select the highest compatible entry.",
        "operationId": "getVersions",
        "responses": {
          "200": {
            "description": "The release manifest.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Release"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Release": {
        "type": "object",
        "description": "A single published MobileBuilds MCP Server release.",
        "required": [
          "version",
          "build",
          "releaseDate",
          "minimumSystemVersion",
          "minimumAppVersion",
          "url",
          "size",
          "sha256",
          "notes"
        ],
        "properties": {
          "version": {
            "type": "string",
            "pattern": "^\\d{4}\\.\\d+$",
            "description": "Server release version, `YYYY.x`. Matches the archive's CFBundleShortVersionString exactly.",
            "examples": [
              "2026.7"
            ]
          },
          "build": {
            "type": "string",
            "description": "Monotonic build number.",
            "examples": [
              "1"
            ]
          },
          "releaseDate": {
            "type": "string",
            "format": "date",
            "description": "Release date, `YYYY-MM-DD`.",
            "examples": [
              "2026-09-03"
            ]
          },
          "minimumSystemVersion": {
            "type": "string",
            "description": "Minimum macOS version required to run this server build.",
            "examples": [
              "26.0"
            ]
          },
          "minimumAppVersion": {
            "type": "string",
            "pattern": "^\\d{4}\\.\\d+$",
            "description": "Minimum MobileBuilds app version (`YYYY.x`) that supports this server build.",
            "examples": [
              "2026.7"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Download URL for the release archive.",
            "examples": [
              "https://helper.mobilebuilds.app/downloads/MobileBuildsMCPServer-2026.7.zip"
            ]
          },
          "size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Size of the release archive in bytes. `null` if the archive is missing at build time.",
            "examples": [
              412
            ]
          },
          "sha256": {
            "type": [
              "string",
              "null"
            ],
            "description": "SHA-256 hex digest of the release archive. `null` if the archive is missing at build time.",
            "examples": [
              "1454e44046ae8893a05f87bc11cb03c30a7469d7d6ae66716c26510855180a50"
            ]
          },
          "notes": {
            "type": "string",
            "description": "Human-readable release notes.",
            "examples": [
              "First release of the MobileBuilds MCP Server."
            ]
          }
        }
      }
    }
  }
}