Developer documentation

Developer documentation for the Perceptis API and MCP server.

Perceptis offers two ways to generate PowerPoint slides and decks programmatically:

• Perceptis API v1 — REST API for server-side integrations, workflow automation, and internal tools that need .pptx output.

• Perceptis MCP server — Model Context Protocol surface for AI assistants (Claude, Cursor, etc.) to generate and edit slides directly from chat.

Perceptis API v1

Start here:

• Overview - how generation jobs work.

• Authentication - create an API key and send it with requests.

• Quickstart: single slide - generate one slide and poll for completion.

• Quickstart: complete deck - generate a complete presentation deck.

Then use these pages as needed:

• Templates - choose a template by name or use automatic template selection.

• Full client script example - run the included generate-and-poll script.

• Errors, rate limits, and billing - handle common API responses.

• API reference - endpoint summaries and request shapes.

Perceptis MCP Server

Use Perceptis directly from any MCP-compatible AI client. The fastest path is connecting from claude.ai's web UI — no API key required.

• Overview - what the MCP server exposes and how it differs from the REST API.

• Authentication - SSO sign-in for claude.ai, or reuse your API key for CLI/desktop clients.

• Quickstart: single slide - connect a client and generate your first slide.

• Quickstart: complete deck - generate a multi-slide deck.

• Tools reference - every tool the server exposes, with costs and parameters.

• Credits and limits - credit costs, rate limits, and download link expiry.

• Error codes - the full list of codes the tools return.