# MagicSlides — how to use (mcp.ai)

Connect your MagicSlides account and use 4 tools for AI content generation straight from your AI agent. Connect with your own API key. MagicSlides generates editable presentations and HTML slide decks from topics, templates, and AI models.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_magicslides?ms=1787296080000`
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. `magicslides_generate_presentation`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/magicslides`
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/magicslides/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/magicslides/generate/presentation` — Create an editable MagicSlides presentation from a topic or source content and return its editor URL. Calling this tool is documented to cost $0.50 per deck. Successful paid generation was not live-ve
  - body: { topic: string, slides?: integer, language?: string, web_search?: boolean, include_images?: boolean, presentation_for?: string, presentation_tone?: string, presentation_type?: string }
- `POST https://api.mcp.ai/api/magicslides/generate/presentation/with/template` — Create a presentation from a topic and a selected ProSlides template, returning HTML slides plus preview, PPTX, and PDF URLs. MagicSlides documents this operation at $0.50 per generated deck. Successf
  - body: { topic: string, slides?: integer, language?: string, template_key: string, presentation_for?: string, presentation_tone?: string, presentation_type?: string }
- `POST https://api.mcp.ai/api/magicslides/list/models` — List the AI model IDs accepted by MagicSlides HTML Studio, including the provider's default and model quality and speed guidance.
- `POST https://api.mcp.ai/api/magicslides/list/templates` — List MagicSlides presentation templates and their valid template keys, optionally restricted to ProSlides HTML-output templates.
  - body: { mode?: string }

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

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