
List workspace folders. Returns folder IDs for use in generate_gamma folderIds parameter. Supports search via query parameter.
Generate presentation/document/webpage/social from text. Returns generationId. Poll getgenerationstatus for result. Use listthemes for themeId, listfolders for folderIds.
Generate from existing gamma template. Requires gammaId of template. Returns generationId. Poll getgenerationstatus for result.
Poll generation status. Returns pending/completed/failed. When completed, returns gammaUrl. Poll every ~5 seconds until done.
List available themes (workspace custom + standard). Returns themeId for use in generate_gamma. Supports search via query parameter.
Validate Gamma credentials. Verifies credentials during setup.

In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}It's an MCP server that connects your agents to Gamma's AI content generation platform via tools. Your agents can invoke these tools to generate presentations, documents, and webpages from text, create content from templates, track generation status, and more.
Gamma offers an official MCP server, but you can also use one from a third-party platform, like Merge Agent Handler.
The use cases naturally depend on the agent you've built, but here are a few common ones:
Here are some of the most commonly used tools:
generate_gamma: creates a new Gamma presentation, document, webpage, or social post from a text prompt, with control over tone, audience, layout, and theme. Use this when an agent needs to produce polished content from scratch based on data or text pulled from another systemgenerate_gamma_from_template: generates new Gamma content using an existing template as the structural and design foundation. Good for workflows that need consistent branded output across recurring reports, proposals, or client-facing decksget_generation_status: checks the status of an in-progress Gamma generation job, returning pending, completed, or failed. Call this when an agent needs to confirm a generation has finished before linking or sharing the output downstreamlist_folders: retrieves workspace folders and their IDs from a Gamma account. Helpful when an agent needs to route generated content into the right folder or locate existing presentations before triggering new oneslist_themes: returns the themes available in a Gamma workspace for customizing visual output. Use this when an agent needs to match generated content to a specific brand theme before kicking off a generation jobGamma has its own official MCP server, but routing it through Merge Agent Handler adds production-grade controls that matter when content generation is part of a larger automated workflow:
You can take the following steps:
1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).
2. Create a new Tool Pack, then find and enable the Gamma connector. Choose tools that fit your workflow: list_folders and list_themes handle discovery and setup, while generate_gamma, generate_gamma_from_template, and get_generation_status are needed for agents that create and track content.
3. Add a Registered User inside the Tool Pack. This is the identity context under which your agent operates. Merge generates a unique MCP URL scoped to this user once it's created.
4. From the Registered User detail page, authenticate Gamma by completing the OAuth flow. Merge stores and manages the credentials going forward.
5. Copy the MCP URL from the Tool Pack detail page and generate an API key from Settings. You'll need both to connect your agent.
6. Add the MCP server to your agent or IDE using the MCP URL and API key. Your Gamma tools are now accessible through that endpoint.
Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to Gamma without bypassing IT governance.
Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity.
IT also provisions access by role or group via SCIM. A marketing manager, for example, gets Gamma access to generate branded decks and docs, HubSpot to pull campaign and contact data, and Google Sheets to track content performance; while a sales rep gets Gamma access to create tailored pitch materials, Salesforce to reference account and deal data, and Gmail to manage prospect outreach.
Every tool call an employee's AI makes to Gamma is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now