MCP Integration - Alai Docs

The Alai MCP Server lets AI agents generate presentations, manage slides, and export content directly through the Model Context Protocol. Authentication is handled via OAuth — your editor opens a browser window for sign-in on first use. No API key required. MCP URL: https://slides-api.getalai.com/mcp/

Getting Started

Run this command in your terminal:

claude mcp add --transport http alai https://slides-api.getalai.com/mcp/

Then type /mcp in a Claude Code session to initiate the OAuth sign-in flow.

Go to Settings → Connectors and add a custom connector with this URL:

https://slides-api.getalai.com/mcp/

Click the + button in the chat box, then Connectors to verify.

Remote MCP connectors are available on Claude Pro, Max, Team, and Enterprise plans.

Open Cursor Settings → MCP and add a new server, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "alai": {
      "type": "streamable-http",
      "url": "https://slides-api.getalai.com/mcp/"
    }
  }
}

Requires VS Code 1.102 or later.

Open the Command Palette (Cmd/Ctrl + Shift + P), run MCP: Add Server, and select HTTP. Use this URL:

https://slides-api.getalai.com/mcp/

Or add it to .vscode/mcp.json:

{
  "servers": {
    "alai": {
      "type": "http",
      "url": "https://slides-api.getalai.com/mcp/"
    }
  }
}

Go to Windsurf Settings → Manage MCPs → View raw config and add:

{
  "mcpServers": {
    "alai": {
      "serverUrl": "https://slides-api.getalai.com/mcp/"
    }
  }
}

Go to Settings → Connectors → Add connector and enter:

https://slides-api.getalai.com/mcp/

ChatGPT will open a browser window for OAuth sign-in.

Custom connectors are available on ChatGPT Pro, Business, and Enterprise plans.

Docs for AI

Give your AI agent access to Alai’s docs so it can look up API endpoints, authentication, webhooks, and more while building. For Claude Code, run this command in your terminal:

claude mcp add alai-docs -- uvx mcpdoc --urls "https://docs.getalai.com/llms.txt"

For Claude Desktop, Cursor, or VS Code, add an MCP server with these settings:

{
  "mcpServers": {
    "alai-docs": {
      "command": "uvx",
      "args": [
        "mcpdoc",
        "--urls",
        "https://docs.getalai.com/llms.txt"
      ]
    }
  }
}

Requires uv (provides uvx). Install with brew install uv or see the installation docs for other platforms. Uses mcpdoc by LangChain. Your agent gets a search tool over all Alai documentation, powered by the auto-generated llms.txt and llms-full.txt indexes.

Available Tools

The Alai MCP server exposes 11 tools that map to the Alai API:

Tool	Description
`ping`	Verify authentication and return user ID
`get_presentations`	List all presentations for the authenticated user
`get_themes`	List theme IDs and names available to the authenticated user
`get_vibes`	List vibe IDs, names, and source (system or custom) for visual style presets
`generate_presentation`	Create a presentation from text content
`get_generation_status`	Poll async operation status
`create_slide`	Add a slide to an existing presentation
`delete_slide`	Remove a slide from a presentation
`export_presentation`	Export to PDF, PPTX, or shareable link
`generate_transcripts`	Generate speaker notes for slides
`delete_presentation`	Permanently delete a presentation

Example Usage

Once connected, ask your AI agent to create presentations:

List available themes

Prompt: “Show me the theme IDs I can use for a presentation”The AI will call get_themes and return the available theme IDs and display names.

Generate a presentation

Prompt: “Create a 5-slide presentation about the benefits of remote work”The AI can call get_themes first to pick a theme, then generate_presentation and poll get_generation_status until complete.

Add a slide to an existing presentation

Prompt: “Add a slide about team collaboration tools to my presentation”

Export to PowerPoint

Prompt: “Export my presentation as a PowerPoint file”

Generate speaker notes

Prompt: “Create speaker notes for all slides in my presentation”

Authentication

Authentication is handled via OAuth 2.1. On first connection, your editor opens a browser window where you sign in to Alai. Tokens refresh automatically. MCP clients discover OAuth configuration via:

GET https://slides-api.getalai.com/.well-known/oauth-protected-resource/mcp

For programmatic access (CI, scripts, direct HTTP), use the Alai REST API with an API key instead.

Workflow

Presentation generation is asynchronous:

Most AI agents handle polling automatically. Just describe what you want and the agent will manage the async workflow.

Troubleshooting

OAuth sign-in window doesn't open

Authentication errors

Re-run the OAuth sign-in flow from your client’s MCP settings
Make sure you’re signed in to the same Alai account your presentations belong to

Tools not appearing

Some clients require a restart after adding MCP servers
Verify the server status indicator (should be green/active)

Rate limits

Maximum 5 concurrent generations per user
Contact founders@getalai.com for higher limits

Next Steps

API Reference

Full API documentation with all endpoints and parameters

Examples

Python examples and use cases for the Alai API

A2A Agent

For autonomous agents that need to delegate edits, not human-driven editors

Alai API (Beta)

​Getting Started

​Docs for AI

​Available Tools

​Example Usage

​Authentication

​Workflow

​Troubleshooting

​Next Steps

API Reference

Examples

A2A Agent

Getting Started

Docs for AI

Available Tools

Example Usage

Authentication

Workflow

Troubleshooting

Next Steps