{
  "openapi": "3.1.0",
  "info": {
    "title": "Example Product Support API",
    "version": "1.0.0",
    "description": "Synthetic documentation example. The example.com server is not a live API."
  },
  "servers": [{ "url": "https://api.example.com" }],
  "paths": {
    "/v1/public/plans/{planId}": {
      "get": {
        "operationId": "getPublicPlan",
        "summary": "Read the documented export limit for a public plan.",
        "security": [],
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": { "type": "string", "enum": ["starter", "team"] }
          }
        ],
        "responses": {
          "200": {
            "description": "The public plan's documented export limit.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/PublicPlan" } }
            }
          },
          "404": { "description": "The public plan was not found." }
        }
      }
    },
    "/v1/admin/keys": {
      "post": {
        "operationId": "createAdminKey",
        "summary": "Example administrative action that must not be exposed by the support MCP.",
        "security": [{ "adminBearer": [] }],
        "responses": { "201": { "description": "Administrative key created. Not implemented in this example." } }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "adminBearer": { "type": "http", "scheme": "bearer" }
    },
    "schemas": {
      "PublicPlan": {
        "type": "object",
        "properties": {
          "planId": { "type": "string", "enum": ["starter", "team"] },
          "maxExportRows": { "type": "integer", "minimum": 1 },
          "sourceUrl": { "type": "string", "format": "uri" }
        },
        "required": ["planId", "maxExportRows", "sourceUrl"],
        "additionalProperties": false
      }
    }
  }
}
