{ "service": "gamma", "displayName": "Gamma", "categories": [ "AI", "Design & Media", "Productivity" ], "authTypes": [ "api_key" ], "auth": [ { "type": "api_key", "label": "API Key", "placeholder": "sk-gamma-...", "description": "Gamma API key sent with the X-API-KEY header. Generate or manage it from Settings > API Keys: https://gamma.app/settings/api-keys." } ], "homepageUrl": "https://gamma.app", "actions": [ { "id": "gamma.create_generation", "service": "gamma", "name": "create_generation", "description": "Create an asynchronous Gamma generation from text input.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "inputText": { "type": "string", "minLength": 1, "description": "The text and image URLs Gamma should use for generation." }, "additionalInstructions": { "type": "string", "maxLength": 5000, "description": "Additional instructions or context for the Gamma generation." }, "textMode": { "type": "string", "enum": [ "generate", "condense", "preserve" ], "description": "How Gamma should interpret the input text." }, "format": { "type": "string", "enum": [ "presentation", "document", "social", "webpage" ], "description": "The output format Gamma should generate." }, "numCards": { "type": "integer", "minimum": 1, "maximum": 75, "description": "The target number of cards Gamma should generate." }, "cardSplit": { "type": "string", "enum": [ "auto", "inputTextBreaks" ], "description": "How Gamma should split the input across cards." }, "themeId": { "type": "string", "minLength": 1, "description": "The Gamma theme ID returned by the List Themes API or copied from the Gamma app." }, "textOptions": { "type": "object", "properties": { "amount": { "type": "string", "enum": [ "brief", "medium", "detailed", "extensive" ], "description": "How much text Gamma should generate for each card." }, "tone": { "type": "string", "minLength": 1, "description": "The desired tone for generated text." }, "audience": { "type": "string", "minLength": 1, "description": "The intended audience for the generated text." }, "language": { "type": "string", "minLength": 1, "description": "The language Gamma should use in the generated text." } }, "additionalProperties": true, "description": "Text generation settings forwarded to Gamma." }, "imageOptions": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "aiGenerated", "pictographic", "pexels", "giphy", "webAllImages", "webFreeToUse", "webFreeToUseCommercially", "themeAccent", "placeholder", "noImages" ], "description": "Where Gamma should source images from for the generation." }, "model": { "type": "string", "minLength": 1, "description": "The image model Gamma should use for AI-generated images." }, "style": { "type": "string", "minLength": 1, "description": "The image style prompt Gamma should use." }, "stylePreset": { "type": "string", "minLength": 1, "description": "A named style preset Gamma should apply to AI-generated images." } }, "additionalProperties": true, "description": "Image generation settings forwarded to Gamma." }, "cardOptions": { "type": "object", "properties": { "dimensions": { "type": "string", "enum": [ "fluid", "16x9", "4x3", "1x1", "4x5", "9x16", "letter", "a4", "pageless" ], "description": "The card or page dimensions Gamma should use for this generation." }, "headerFooter": { "type": "object", "properties": { "topLeft": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "topCenter": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "topRight": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "bottomLeft": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "bottomCenter": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "bottomRight": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "hideFromFirstCard": { "type": "boolean", "description": "Whether Gamma hides the header and footer on the first card." }, "hideFromLastCard": { "type": "boolean", "description": "Whether Gamma hides the header and footer on the last card." } }, "additionalProperties": true, "description": "Header and footer settings for Gamma cards." } }, "additionalProperties": true, "description": "Card layout settings forwarded to Gamma." }, "sharingOptions": { "type": "object", "properties": { "workspaceAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to workspace members." }, "externalAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit" ], "description": "The access level Gamma should grant to users outside the workspace." }, "emailOptions": { "type": "object", "properties": { "recipients": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "The email recipients Gamma should share the result with.", "minItems": 1 }, "access": { "type": "string", "enum": [ "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to shared email recipients." } }, "additionalProperties": true, "description": "Email sharing settings forwarded to Gamma." } }, "additionalProperties": true, "description": "Sharing and access settings forwarded to Gamma." }, "folderIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Gamma folder ID." }, "description": "The folder IDs where Gamma should place the generated content.", "minItems": 1, "maxItems": 10 }, "exportAs": { "type": "string", "enum": [ "pdf", "pptx", "png" ], "description": "The export format Gamma should prepare when generation completes." } }, "additionalProperties": false, "required": [ "inputText", "textMode" ], "description": "Input for creating a Gamma generation from text." }, "outputSchema": { "type": "object", "properties": { "generation": { "type": "object", "properties": { "generationId": { "type": "string", "description": "The Gamma generation job identifier." }, "status": { "type": "string", "enum": [ "pending", "completed", "failed" ], "description": "The current status of the Gamma generation." }, "gammaId": { "type": "string", "description": "The Gamma document ID returned when available." }, "gammaUrl": { "type": "string", "description": "The Gamma document URL returned when complete.", "format": "uri" }, "exportUrl": { "type": "string", "description": "The temporary export download URL returned when complete.", "format": "uri" }, "warnings": { "type": "string", "description": "Warnings Gamma returned because some generation settings were ignored." }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message Gamma returned for a failed generation." }, "statusCode": { "type": "integer", "description": "The HTTP-like status code Gamma returned for a failed generation." } }, "additionalProperties": false, "description": "The error payload Gamma returned for a failed generation." }, "credits": { "type": "object", "properties": { "deducted": { "type": "integer", "description": "The number of credits deducted for this generation." }, "remaining": { "type": "integer", "description": "The number of credits remaining after this generation." } }, "additionalProperties": false, "description": "Gamma credit usage returned for a generation." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "A Gamma generation job or completed generation result." } }, "additionalProperties": false, "required": [ "generation" ], "description": "The Gamma generation status and result payload." } }, { "id": "gamma.create_generation_and_wait", "service": "gamma", "name": "create_generation_and_wait", "description": "Create a Gamma generation from text input and keep polling until it completes, fails, or times out.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "inputText": { "type": "string", "minLength": 1, "description": "The text and image URLs Gamma should use for generation." }, "additionalInstructions": { "type": "string", "maxLength": 5000, "description": "Additional instructions or context for the Gamma generation." }, "textMode": { "type": "string", "enum": [ "generate", "condense", "preserve" ], "description": "How Gamma should interpret the input text." }, "format": { "type": "string", "enum": [ "presentation", "document", "social", "webpage" ], "description": "The output format Gamma should generate." }, "numCards": { "type": "integer", "minimum": 1, "maximum": 75, "description": "The target number of cards Gamma should generate." }, "cardSplit": { "type": "string", "enum": [ "auto", "inputTextBreaks" ], "description": "How Gamma should split the input across cards." }, "themeId": { "type": "string", "minLength": 1, "description": "The Gamma theme ID returned by the List Themes API or copied from the Gamma app." }, "textOptions": { "type": "object", "properties": { "amount": { "type": "string", "enum": [ "brief", "medium", "detailed", "extensive" ], "description": "How much text Gamma should generate for each card." }, "tone": { "type": "string", "minLength": 1, "description": "The desired tone for generated text." }, "audience": { "type": "string", "minLength": 1, "description": "The intended audience for the generated text." }, "language": { "type": "string", "minLength": 1, "description": "The language Gamma should use in the generated text." } }, "additionalProperties": true, "description": "Text generation settings forwarded to Gamma." }, "imageOptions": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "aiGenerated", "pictographic", "pexels", "giphy", "webAllImages", "webFreeToUse", "webFreeToUseCommercially", "themeAccent", "placeholder", "noImages" ], "description": "Where Gamma should source images from for the generation." }, "model": { "type": "string", "minLength": 1, "description": "The image model Gamma should use for AI-generated images." }, "style": { "type": "string", "minLength": 1, "description": "The image style prompt Gamma should use." }, "stylePreset": { "type": "string", "minLength": 1, "description": "A named style preset Gamma should apply to AI-generated images." } }, "additionalProperties": true, "description": "Image generation settings forwarded to Gamma." }, "cardOptions": { "type": "object", "properties": { "dimensions": { "type": "string", "enum": [ "fluid", "16x9", "4x3", "1x1", "4x5", "9x16", "letter", "a4", "pageless" ], "description": "The card or page dimensions Gamma should use for this generation." }, "headerFooter": { "type": "object", "properties": { "topLeft": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "topCenter": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "topRight": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "bottomLeft": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "bottomCenter": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "bottomRight": { "oneOf": [ { "type": "object", "properties": { "type": { "const": "text", "type": "string", "description": "The header or footer content type." }, "value": { "type": "string", "description": "The text shown in the header or footer." } }, "additionalProperties": false, "description": "Text content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "image", "type": "string", "description": "The header or footer content type." }, "source": { "type": "string", "enum": [ "themeLogo", "custom" ], "description": "Whether Gamma should use the theme logo or a custom image URL." }, "src": { "anyOf": [ { "type": "string", "description": "The image URL used when source is custom.", "format": "uri" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "enum": [ "sm", "md", "lg", "xl" ], "description": "The image size Gamma should use in the header or footer." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "type", "source" ], "description": "Image content shown in a Gamma header or footer." }, { "type": "object", "properties": { "type": { "const": "cardNumber", "type": "string", "description": "The header or footer content type." } }, "additionalProperties": false, "description": "Card number content shown in a Gamma header or footer." } ], "description": "A Gamma header or footer content block." }, "hideFromFirstCard": { "type": "boolean", "description": "Whether Gamma hides the header and footer on the first card." }, "hideFromLastCard": { "type": "boolean", "description": "Whether Gamma hides the header and footer on the last card." } }, "additionalProperties": true, "description": "Header and footer settings for Gamma cards." } }, "additionalProperties": true, "description": "Card layout settings forwarded to Gamma." }, "sharingOptions": { "type": "object", "properties": { "workspaceAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to workspace members." }, "externalAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit" ], "description": "The access level Gamma should grant to users outside the workspace." }, "emailOptions": { "type": "object", "properties": { "recipients": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "The email recipients Gamma should share the result with.", "minItems": 1 }, "access": { "type": "string", "enum": [ "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to shared email recipients." } }, "additionalProperties": true, "description": "Email sharing settings forwarded to Gamma." } }, "additionalProperties": true, "description": "Sharing and access settings forwarded to Gamma." }, "folderIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Gamma folder ID." }, "description": "The folder IDs where Gamma should place the generated content.", "minItems": 1, "maxItems": 10 }, "exportAs": { "type": "string", "enum": [ "pdf", "pptx", "png" ], "description": "The export format Gamma should prepare when generation completes." }, "timeoutSeconds": { "type": "number", "minimum": 0, "description": "The maximum number of seconds to wait before returning a timed-out result." }, "pollIntervalSeconds": { "type": "number", "minimum": 0, "description": "The number of seconds to wait between polling attempts." } }, "additionalProperties": false, "required": [ "inputText", "textMode" ], "description": "Input for creating a Gamma generation from text and waiting for the result." }, "outputSchema": { "type": "object", "properties": { "generation": { "type": "object", "properties": { "generationId": { "type": "string", "description": "The Gamma generation job identifier." }, "status": { "type": "string", "enum": [ "pending", "completed", "failed" ], "description": "The current status of the Gamma generation." }, "gammaId": { "type": "string", "description": "The Gamma document ID returned when available." }, "gammaUrl": { "type": "string", "description": "The Gamma document URL returned when complete.", "format": "uri" }, "exportUrl": { "type": "string", "description": "The temporary export download URL returned when complete.", "format": "uri" }, "warnings": { "type": "string", "description": "Warnings Gamma returned because some generation settings were ignored." }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message Gamma returned for a failed generation." }, "statusCode": { "type": "integer", "description": "The HTTP-like status code Gamma returned for a failed generation." } }, "additionalProperties": false, "description": "The error payload Gamma returned for a failed generation." }, "credits": { "type": "object", "properties": { "deducted": { "type": "integer", "description": "The number of credits deducted for this generation." }, "remaining": { "type": "integer", "description": "The number of credits remaining after this generation." } }, "additionalProperties": false, "description": "Gamma credit usage returned for a generation." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "A Gamma generation job or completed generation result." }, "timedOut": { "type": "boolean", "description": "Whether the polling loop stopped because the timeout was reached." } }, "additionalProperties": false, "required": [ "generation", "timedOut" ], "description": "The Gamma generation returned by a polling helper." } }, { "id": "gamma.create_generation_from_template", "service": "gamma", "name": "create_generation_from_template", "description": "Create an asynchronous Gamma generation from an existing Gamma template.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "prompt": { "type": "string", "minLength": 1, "description": "The prompt Gamma should use to adapt the template." }, "gammaId": { "type": "string", "minLength": 1, "description": "The Gamma template identifier to use as the base template." }, "themeId": { "type": "string", "minLength": 1, "description": "The Gamma theme ID returned by the List Themes API or copied from the Gamma app." }, "imageOptions": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "aiGenerated", "pictographic", "pexels", "giphy", "webAllImages", "webFreeToUse", "webFreeToUseCommercially", "themeAccent", "placeholder", "noImages" ], "description": "Where Gamma should source images from for the generation." }, "model": { "type": "string", "minLength": 1, "description": "The image model Gamma should use for AI-generated images." }, "style": { "type": "string", "minLength": 1, "description": "The image style prompt Gamma should use." }, "stylePreset": { "type": "string", "minLength": 1, "description": "A named style preset Gamma should apply to AI-generated images." } }, "additionalProperties": true, "description": "Image generation settings forwarded to Gamma." }, "sharingOptions": { "type": "object", "properties": { "workspaceAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to workspace members." }, "externalAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit" ], "description": "The access level Gamma should grant to users outside the workspace." }, "emailOptions": { "type": "object", "properties": { "recipients": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "The email recipients Gamma should share the result with.", "minItems": 1 }, "access": { "type": "string", "enum": [ "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to shared email recipients." } }, "additionalProperties": true, "description": "Email sharing settings forwarded to Gamma." } }, "additionalProperties": true, "description": "Sharing and access settings forwarded to Gamma." }, "folderIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Gamma folder ID." }, "description": "The folder IDs where Gamma should place the generated content.", "minItems": 1, "maxItems": 10 }, "exportAs": { "type": "string", "enum": [ "pdf", "pptx", "png" ], "description": "The export format Gamma should prepare when generation completes." } }, "additionalProperties": false, "required": [ "prompt", "gammaId" ], "description": "Input for creating a Gamma generation from a template." }, "outputSchema": { "type": "object", "properties": { "generation": { "type": "object", "properties": { "generationId": { "type": "string", "description": "The Gamma generation job identifier." }, "status": { "type": "string", "enum": [ "pending", "completed", "failed" ], "description": "The current status of the Gamma generation." }, "gammaId": { "type": "string", "description": "The Gamma document ID returned when available." }, "gammaUrl": { "type": "string", "description": "The Gamma document URL returned when complete.", "format": "uri" }, "exportUrl": { "type": "string", "description": "The temporary export download URL returned when complete.", "format": "uri" }, "warnings": { "type": "string", "description": "Warnings Gamma returned because some generation settings were ignored." }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message Gamma returned for a failed generation." }, "statusCode": { "type": "integer", "description": "The HTTP-like status code Gamma returned for a failed generation." } }, "additionalProperties": false, "description": "The error payload Gamma returned for a failed generation." }, "credits": { "type": "object", "properties": { "deducted": { "type": "integer", "description": "The number of credits deducted for this generation." }, "remaining": { "type": "integer", "description": "The number of credits remaining after this generation." } }, "additionalProperties": false, "description": "Gamma credit usage returned for a generation." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "A Gamma generation job or completed generation result." } }, "additionalProperties": false, "required": [ "generation" ], "description": "The Gamma generation status and result payload." } }, { "id": "gamma.create_generation_from_template_and_wait", "service": "gamma", "name": "create_generation_from_template_and_wait", "description": "Create a Gamma generation from a template and keep polling until it completes, fails, or times out.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "prompt": { "type": "string", "minLength": 1, "description": "The prompt Gamma should use to adapt the template." }, "gammaId": { "type": "string", "minLength": 1, "description": "The Gamma template identifier to use as the base template." }, "themeId": { "type": "string", "minLength": 1, "description": "The Gamma theme ID returned by the List Themes API or copied from the Gamma app." }, "imageOptions": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "aiGenerated", "pictographic", "pexels", "giphy", "webAllImages", "webFreeToUse", "webFreeToUseCommercially", "themeAccent", "placeholder", "noImages" ], "description": "Where Gamma should source images from for the generation." }, "model": { "type": "string", "minLength": 1, "description": "The image model Gamma should use for AI-generated images." }, "style": { "type": "string", "minLength": 1, "description": "The image style prompt Gamma should use." }, "stylePreset": { "type": "string", "minLength": 1, "description": "A named style preset Gamma should apply to AI-generated images." } }, "additionalProperties": true, "description": "Image generation settings forwarded to Gamma." }, "sharingOptions": { "type": "object", "properties": { "workspaceAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to workspace members." }, "externalAccess": { "type": "string", "enum": [ "noAccess", "view", "comment", "edit" ], "description": "The access level Gamma should grant to users outside the workspace." }, "emailOptions": { "type": "object", "properties": { "recipients": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "The email recipients Gamma should share the result with.", "minItems": 1 }, "access": { "type": "string", "enum": [ "view", "comment", "edit", "fullAccess" ], "description": "The access level Gamma should grant to shared email recipients." } }, "additionalProperties": true, "description": "Email sharing settings forwarded to Gamma." } }, "additionalProperties": true, "description": "Sharing and access settings forwarded to Gamma." }, "folderIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Gamma folder ID." }, "description": "The folder IDs where Gamma should place the generated content.", "minItems": 1, "maxItems": 10 }, "exportAs": { "type": "string", "enum": [ "pdf", "pptx", "png" ], "description": "The export format Gamma should prepare when generation completes." }, "timeoutSeconds": { "type": "number", "minimum": 0, "description": "The maximum number of seconds to wait before returning a timed-out result." }, "pollIntervalSeconds": { "type": "number", "minimum": 0, "description": "The number of seconds to wait between polling attempts." } }, "additionalProperties": false, "required": [ "prompt", "gammaId" ], "description": "Input for creating a template-based Gamma generation and waiting for the result." }, "outputSchema": { "type": "object", "properties": { "generation": { "type": "object", "properties": { "generationId": { "type": "string", "description": "The Gamma generation job identifier." }, "status": { "type": "string", "enum": [ "pending", "completed", "failed" ], "description": "The current status of the Gamma generation." }, "gammaId": { "type": "string", "description": "The Gamma document ID returned when available." }, "gammaUrl": { "type": "string", "description": "The Gamma document URL returned when complete.", "format": "uri" }, "exportUrl": { "type": "string", "description": "The temporary export download URL returned when complete.", "format": "uri" }, "warnings": { "type": "string", "description": "Warnings Gamma returned because some generation settings were ignored." }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message Gamma returned for a failed generation." }, "statusCode": { "type": "integer", "description": "The HTTP-like status code Gamma returned for a failed generation." } }, "additionalProperties": false, "description": "The error payload Gamma returned for a failed generation." }, "credits": { "type": "object", "properties": { "deducted": { "type": "integer", "description": "The number of credits deducted for this generation." }, "remaining": { "type": "integer", "description": "The number of credits remaining after this generation." } }, "additionalProperties": false, "description": "Gamma credit usage returned for a generation." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "A Gamma generation job or completed generation result." }, "timedOut": { "type": "boolean", "description": "Whether the polling loop stopped because the timeout was reached." } }, "additionalProperties": false, "required": [ "generation", "timedOut" ], "description": "The Gamma generation returned by a polling helper." } }, { "id": "gamma.get_generation", "service": "gamma", "name": "get_generation", "description": "Get the status and result URLs for a specific Gamma generation job.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "generationId": { "type": "string", "minLength": 1, "description": "The Gamma generation job identifier." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "Input for fetching a Gamma generation result." }, "outputSchema": { "type": "object", "properties": { "generation": { "type": "object", "properties": { "generationId": { "type": "string", "description": "The Gamma generation job identifier." }, "status": { "type": "string", "enum": [ "pending", "completed", "failed" ], "description": "The current status of the Gamma generation." }, "gammaId": { "type": "string", "description": "The Gamma document ID returned when available." }, "gammaUrl": { "type": "string", "description": "The Gamma document URL returned when complete.", "format": "uri" }, "exportUrl": { "type": "string", "description": "The temporary export download URL returned when complete.", "format": "uri" }, "warnings": { "type": "string", "description": "Warnings Gamma returned because some generation settings were ignored." }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message Gamma returned for a failed generation." }, "statusCode": { "type": "integer", "description": "The HTTP-like status code Gamma returned for a failed generation." } }, "additionalProperties": false, "description": "The error payload Gamma returned for a failed generation." }, "credits": { "type": "object", "properties": { "deducted": { "type": "integer", "description": "The number of credits deducted for this generation." }, "remaining": { "type": "integer", "description": "The number of credits remaining after this generation." } }, "additionalProperties": false, "description": "Gamma credit usage returned for a generation." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "A Gamma generation job or completed generation result." } }, "additionalProperties": false, "required": [ "generation" ], "description": "The Gamma generation status and result payload." } }, { "id": "gamma.list_folders", "service": "gamma", "name": "list_folders", "description": "List the Gamma folders available in the current workspace.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "description": "An optional search query for filtering folders by name." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "The maximum number of folders Gamma should return." }, "after": { "type": "string", "minLength": 1, "description": "The cursor for loading the next page of folders." } }, "additionalProperties": false, "description": "Filters for listing Gamma folders." }, "outputSchema": { "type": "object", "properties": { "folders": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Gamma folder identifier." }, "name": { "type": "string", "description": "The display name of the Gamma folder." } }, "additionalProperties": false, "description": "A Gamma folder." }, "description": "The Gamma folders returned by the API." }, "pageInfo": { "type": "object", "properties": { "hasMore": { "type": "boolean", "description": "Whether more pages are available from Gamma." }, "nextCursor": { "anyOf": [ { "type": "string", "description": "The cursor value to pass as after when requesting the next page." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "Cursor pagination information returned by Gamma." } }, "additionalProperties": false, "required": [ "folders", "pageInfo" ], "description": "The Gamma folder list response." } }, { "id": "gamma.list_themes", "service": "gamma", "name": "list_themes", "description": "List the Gamma themes available in the current workspace.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "description": "An optional search query for filtering themes by name." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "The maximum number of themes Gamma should return." }, "after": { "type": "string", "minLength": 1, "description": "The cursor for loading the next page of themes." } }, "additionalProperties": false, "description": "Filters for listing Gamma themes." }, "outputSchema": { "type": "object", "properties": { "themes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Gamma theme identifier." }, "name": { "type": "string", "description": "The display name of the Gamma theme." }, "type": { "type": "string", "description": "The theme type returned by Gamma." }, "toneKeywords": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "The descriptive tone keywords associated with the theme." }, "colorKeywords": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "The descriptive color keywords associated with the theme." } }, "additionalProperties": false, "description": "A Gamma theme." }, "description": "The Gamma themes returned by the API." }, "pageInfo": { "type": "object", "properties": { "hasMore": { "type": "boolean", "description": "Whether more pages are available from Gamma." }, "nextCursor": { "anyOf": [ { "type": "string", "description": "The cursor value to pass as after when requesting the next page." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "Cursor pagination information returned by Gamma." } }, "additionalProperties": false, "required": [ "themes", "pageInfo" ], "description": "The Gamma theme list response." } }, { "id": "gamma.wait_for_generation", "service": "gamma", "name": "wait_for_generation", "description": "Poll a Gamma generation job until it completes, fails, or the polling timeout is reached.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "generationId": { "type": "string", "minLength": 1, "description": "The Gamma generation job identifier." }, "timeoutSeconds": { "type": "number", "minimum": 0, "description": "The maximum number of seconds to wait before returning a timed-out result." }, "pollIntervalSeconds": { "type": "number", "minimum": 0, "description": "The number of seconds to wait between polling attempts." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "Input for waiting on a Gamma generation result." }, "outputSchema": { "type": "object", "properties": { "generation": { "type": "object", "properties": { "generationId": { "type": "string", "description": "The Gamma generation job identifier." }, "status": { "type": "string", "enum": [ "pending", "completed", "failed" ], "description": "The current status of the Gamma generation." }, "gammaId": { "type": "string", "description": "The Gamma document ID returned when available." }, "gammaUrl": { "type": "string", "description": "The Gamma document URL returned when complete.", "format": "uri" }, "exportUrl": { "type": "string", "description": "The temporary export download URL returned when complete.", "format": "uri" }, "warnings": { "type": "string", "description": "Warnings Gamma returned because some generation settings were ignored." }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message Gamma returned for a failed generation." }, "statusCode": { "type": "integer", "description": "The HTTP-like status code Gamma returned for a failed generation." } }, "additionalProperties": false, "description": "The error payload Gamma returned for a failed generation." }, "credits": { "type": "object", "properties": { "deducted": { "type": "integer", "description": "The number of credits deducted for this generation." }, "remaining": { "type": "integer", "description": "The number of credits remaining after this generation." } }, "additionalProperties": false, "description": "Gamma credit usage returned for a generation." } }, "additionalProperties": false, "required": [ "generationId" ], "description": "A Gamma generation job or completed generation result." }, "timedOut": { "type": "boolean", "description": "Whether the polling loop stopped because the timeout was reached." } }, "additionalProperties": false, "required": [ "generation", "timedOut" ], "description": "The Gamma generation returned by a polling helper." } } ] }