> For the complete documentation index, see [llms.txt](https://docs.perceptis.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perceptis.ai/readme.md).

# Developer documentation

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**](/perceptis-api-v1/public-api.md) - how generation jobs work.
* [**Authentication**](/perceptis-api-v1/authentication.md) - create an API key and send it with requests.
* [**Quickstart: single slide**](/perceptis-api-v1/quickstart-single-slide.md) - generate one slide and poll for completion.
* [**Quickstart: complete deck**](/perceptis-api-v1/quickstart-deck.md) - generate a complete presentation deck.

Then use these pages as needed:

* [**Templates**](/perceptis-api-v1/templates.md) - choose a template by name or use automatic template selection.
* [**Full client script example**](/perceptis-api-v1/examples.md) - run the included generate-and-poll script.
* [**Errors, rate limits, and billing**](/perceptis-api-v1/errors-and-limits.md) - handle common API responses.
* [**API reference**](/api-reference/reference.md) - 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**](/perceptis-mcp-server/mcp.md) - what the MCP server exposes and how it differs from the REST API.
* [**Authentication**](/perceptis-mcp-server/authentication.md) - SSO sign-in for claude.ai, or reuse your API key for CLI/desktop clients.
* [**Quickstart: single slide**](/perceptis-mcp-server/quickstart-slide.md) - connect a client and generate your first slide.
* [**Quickstart: complete deck**](/perceptis-mcp-server/quickstart-deck.md) - generate a multi-slide deck.
* [**Tools reference**](/perceptis-mcp-server/tools.md) - every tool the server exposes, with costs and parameters.
* [**Credits and limits**](/perceptis-mcp-server/credits-and-limits.md) - credit costs, rate limits, and download link expiry.
* [**Error codes**](/perceptis-mcp-server/errors.md) - the full list of codes the tools return.