> 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/perceptis-mcp-server/credits-and-limits.md).

# Credits and limits

## Credit costs

| Operation               | Cost               |
| ----------------------- | ------------------ |
| Generate a single slide | 1 credit           |
| Generate a deck         | 1 credit per slide |
| Any edit                | Free               |

Credits are shared across your organization. View your balance from the main app. Deck credits are charged after the storyline phase — the final count depends on how many slides the AI generates.

## Timeouts

Each polling window lasts \~3 minutes. If generation is still running, the AI automatically retries (up to 10 times) until the result is ready or an error occurs.

## Rate limits

The MCP surface applies a per-user sliding-window limit so a runaway client loop can't exhaust capacity for the rest of your org:

| Tool category                                                                                                                | Limit                |
| ---------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| Generation and edit tools (`generate_slide`, `edit_slide`, `generate_deck`, `render_deck`, `export_deck`, `edit_deck_slide`) | 60 calls per minute  |
| Read tools (`check_generation_status`, `show_slide_preview`, `list_templates`)                                               | 600 calls per minute |

When a limit is exceeded the tool returns `{"error": "...", "code": "rate_limited", "retry_after_seconds": 60}`. Wait a minute, then retry.

## Download links

* **Single-slide download links** expire after **30 minutes**.
* **Deck download links** (the merged `.pptx`) expire after **1 hour**.

If a link expires, ask your AI client to show the slide or deck preview again to get a fresh one.