> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.perceptis.ai/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.