> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poesius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Poesius API

> Complete guide for using the Poesius API and MCP to create presentations from documents

## Overview

The Poesius platform provides two main interfaces for generating presentations:

* **REST API**: Traditional HTTP REST endpoints for programmatic access
* **MCP (Model Context Protocol)**: Protocol-based interface for AI assistants like Claude

**Production Endpoint**: `https://poe.poesius.com/api/v1`

**Web App**: `https://app.poesius.com` (for API token management and template design)

## How It Works

Poesius generates professional presentations through a three-step process:

1. **Generate narrative** - Creates McKinsey-style presentation stories, summarizing key findings and revealing insights
2. **Retrieve layouts** - Gets template specifications including colors, layout zones, and design elements (defined visually in the web app)
3. **Create slides** - Combines narrative with template specs to produce professional PPTX files

<Card title="Learn More" icon="info-circle" href="/how-it-works">
  Understand the complete generation process
</Card>

<Card title="Quick Start" icon="rocket" href="/quickstart" horizontal>
  Get up and running in minutes with our quick start guide.
</Card>

## Get started

Learn the basics and start building with Poesius.

<Columns cols={2}>
  <Card title="Quick Start" icon="bolt" href="/quickstart">
    Follow our quick start guide to create your first presentation.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to authenticate and get your API keys.
  </Card>
</Columns>

## API Usage

Use REST API endpoints to generate presentations programmatically.

<Columns cols={2}>
  <Card title="API Overview" icon="server" href="/api/overview">
    Understand the REST API structure and base URLs.
  </Card>

  <Card title="Generate Slides" icon="wand-magic-sparkles" href="/api/generate-slides">
    Create presentations from documents using the API.
  </Card>

  <Card title="Check Status" icon="circle-check" href="/api/check-status">
    Monitor presentation generation status.
  </Card>

  <Card title="Download Presentation" icon="download" href="/api/download-presentation">
    Download completed presentations as PPTX files.
  </Card>
</Columns>

## MCP Usage

Use Model Context Protocol for AI assistant integration.

<Columns cols={2}>
  <Card title="MCP Overview" icon="robot" href="/mcp/overview">
    Learn about the MCP interface and how it works.
  </Card>

  <Card title="Generate Slides (MCP)" icon="wand-magic" href="/mcp/generate-slides">
    End-to-end slide generation using MCP tools.
  </Card>

  <Card title="List Templates" icon="list" href="/mcp/list-templates">
    Discover available presentation templates.
  </Card>

  <Card title="Two-Step Process" icon="diagram-project" href="/mcp/two-step-process">
    Generate content first, then create slides separately.
  </Card>
</Columns>

## Templates & Configuration

Customize your presentations with templates and settings.

<Columns cols={2}>
  <Card title="Templates Overview" icon="palette" href="/templates/overview">
    Understand how templates work and their structure.
  </Card>

  <Card title="Selecting Templates" icon="check-circle" href="/templates/selecting-templates">
    Learn how to choose and use templates.
  </Card>

  <Card title="Slide Count" icon="hashtag" href="/templates/slide-count">
    Control the number of slides in your presentations.
  </Card>
</Columns>

## Examples

See real-world examples of using the Poesius API.

<Card title="View Examples" icon="code" href="/examples/rest-api">
  Browse complete code examples for REST API and MCP usage.
</Card>