# Gamma — how to use (mcp.ai)

Connect your Gamma account and use 5 tools for AI content generation straight from your AI agent. Connect with your own API key. Gamma helps create beautiful, interactive content and presentations using AI. This integration enables programmatic generation via Gamma’s API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gamma?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gamma_create_from_template`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gamma`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gamma/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gamma/create/from/template` — Tool to create new Gamma content based on an existing template. Use when you need to generate content with a predefined structure/layout by providing custom instructions and prompt. The API creates co
  - body: { prompt: string, gammaId: string, themeId?: string, exportAs?: string, folderIds?: string[], imageOptions?: object, sharingOptions?: object }
- `POST https://api.mcp.ai/api/gamma/generate/gamma` — Generate a Gamma presentation, document, webpage, or social media content using AI. Documentation: https://developers.gamma.app/docs/generate-api-parameters-explained The API creates content asynchron
  - body: { format?: string, themeId?: string, exportAs?: string, numCards?: integer, textMode: string, cardSplit?: string, folderIds?: string[], inputText: string, cardOptions?: object, textOptions?: object, imageOptions?: object, sharingOptions?: object, additionalInstructions?: string }
- `POST https://api.mcp.ai/api/gamma/get/gamma/file/urls` — Retrieve generation status and file URLs. Poll this endpoint every ~5 seconds until status is 'completed'. Docs: https://developers.gamma.app/reference/get-generation-status
  - body: { generation_id: string }
- `POST https://api.mcp.ai/api/gamma/list/folders` — Tool to retrieve a paginated list of folders in your Gamma workspace. Use when you need folder IDs to organize generated content or to search for specific folders by name.
  - body: { after?: string, limit?: integer, query?: string }
- `POST https://api.mcp.ai/api/gamma/list/themes` — Fetch the list of themes available in your workspace. Returns both standard (global) and custom (workspace-specific) themes in a paginated format. Use this to discover available theme IDs and names fo
  - body: { after?: string, limit?: integer, query?: string }

## Example prompts
- "What can I do in Gamma?"
- "Show me a summary of my Gamma account"

## More
- Page: https://mcp.ai/gamma
- Agent spec (llms.txt): https://mcp.ai/gamma/llms.txt
- Postman collection: https://mcp.ai/gamma/postman.json