{
  "id": "osc-stack-agent-hosted-swagger-editor",
  "job": "Have your AI coding tool (Claude Code, Codex or any MCP client) set up a private, hosted Swagger Editor for your team, optionally opening your own OpenAPI spec on every page load, and hand back the editor URL. The spec stays in your repository; the editor instance stores nothing.",
  "aliases": [
    "hosted swagger editor my agent sets up",
    "private swagger editor instance",
    "self-hosted openapi editor for a team",
    "swagger editor that opens our spec from git"
  ],
  "distinctFrom": [
    {
      "stack": "provision-agent-backend",
      "difference": "That stack hands a database and object storage to an app. This one runs a single browser tool for people, with no database and no storage."
    },
    {
      "stack": "deploy-agent-written-app",
      "difference": "That stack runs the agent's own code as a My App. This one runs an unmodified catalog service and writes no code."
    }
  ],
  "inputs": [
    {
      "protocol": "MCP",
      "source": "an MCP client connected to https://mcp.osaas.io/mcp (operator mode: read tools via osc_call_tool, writes via osc_write_tool)"
    },
    {
      "protocol": "HTTPS",
      "source": "optional: a public URL of an OpenAPI YAML or JSON file, for example the raw URL of the spec in the team's git repository"
    }
  ],
  "outputs": [
    {
      "protocol": "HTTPS",
      "consumer": "people on the team, in a browser",
      "reachability": "the instance URL returned by create-service-instance; the editor itself asks for no login (docs.osaas.io Service: Swagger Editor, read 2026-10-22)"
    }
  ],
  "recommendedPath": {
    "chain": [
      {
        "step": 1,
        "serviceId": "swagger-api-swagger-editor",
        "role": "browser-based OpenAPI editor with live documentation preview",
        "requiredConfig": ["name"],
        "requiresCredential": false,
        "note": "The only other field is the optional ApiDefinitionUrl. When it is set, the editor fetches and loads that definition each time the page is opened (docs.osaas.io Service: Swagger Editor, read 2026-10-22). Point it at the raw URL of the spec in the repository. Instance names are lower-case alphanumeric, at most 20 characters. Ask the user for the spec URL; never invent one.",
        "mcpTool": "create-service-instance"
      },
      {
        "step": 2,
        "role": "confirm running and hand back the URL",
        "mcpTools": ["wait-for-service-ready", "list-service-instances"],
        "note": "Return the instance URL. Changes made in the editor are not saved by the instance: download them with File > Save as YAML, or Convert and save as JSON, and commit them to the repository."
      }
    ]
  },
  "configSurface": {
    "servicesInChain": 1,
    "totalRequiredFieldsAcrossChain": 1,
    "sensitiveFields": [],
    "note": "get-service-schema on swagger-api-swagger-editor, 2026-10-22: configOptions name (required) and ApiDefinitionUrl (optional); no storage or volume field; serviceAssociations []."
  },
  "setup": {
    "codeRequired": false,
    "knownDeployGotcha": "The instance has no storage setting, so it keeps no spec between sessions. Keep the spec in the repository and use ApiDefinitionUrl to open it."
  },
  "cost": {
    "unit": "tokens/day",
    "ceiling": 10,
    "ceilingSource": "estimate-service-cost on swagger-api-swagger-editor, 2026-10-22 (ceiling rate; observed burn is typically lower per the tool's own note)",
    "freePlanTokens": 100,
    "freePlanTokensAreOneTime": true,
    "daysToExhaustFreePlan": 10,
    "cheapestPlanCoveringContinuousUse": {
      "name": "Personal",
      "eurPerMonth": 15,
      "tokensPerDay": 40
    },
    "pricingSource": "https://www.osaas.io/pricing"
  },
  "servicesVerifiedLive": {
    "date": "2026-10-22",
    "method": "osc_call_tool get-service-schema and estimate-service-cost on swagger-api-swagger-editor (2026-10-22); list-service-categories (2026-10-22).",
    "catalogTotal": 199,
    "catalogTotalSource": "list-service-categories, 2026-10-22"
  },
  "gateCheck": {
    "gatedServiceId": "eyevinn-just-go-live",
    "usesGatedService": false,
    "note": "This stack does not name or link eyevinn-just-go-live; the P3 gate does not bind it."
  },
  "verifiedOn": "2026-10-22",
  "publishedAt": "https://www.osaas.io/service/swagger-api-swagger-editor",
  "descriptorUrl": "https://www.osaas.io/stacks/agent-hosted-swagger-editor.json"
}
