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

# Tools

> What the Visk MCP server exposes and how an editing session works

You don't need to learn these — your AI discovers them automatically when it connects, and calls `fetch_instructions` to teach itself the full Visk format before building anything. This page is a reference for what's under the hood.

## How a session works

Everything happens inside an editing session. The AI starts one with `create_pptx_session` and gets back a session id; the deck then lives on Visk's side, so each edit is a small, targeted call rather than re-sending the whole document, and the AI can come back to the same id later to pick up where it left off.

```text A typical flow theme={null}
create_pptx_session  →  upload your template
add_slides           →  build on the master layouts
screenshot           →  check the result, fix what's off
export               →  download the finished .pptx
```

## Sessions & files

| Tool                  | Description                                                                      |
| --------------------- | -------------------------------------------------------------------------------- |
| `create_pptx_session` | Start an editing session — blank, from inline HTML, or ready for a .pptx upload. |
| `load`                | Open an uploaded file in the session.                                            |
| `upload_asset`        | Upload images or fonts for use in the deck, or another file for merging.         |
| `merge`               | Bring slides in from another uploaded file or a second session.                  |

## Building slides

| Tool                   | Description                                                                |
| ---------------------- | -------------------------------------------------------------------------- |
| `add_slides`           | Add slides built on the deck's master layouts — on-brand by construction.  |
| `add_slides_from_html` | Add slides written as HTML, including native editable charts and diagrams. |
| `add_layouts`          | Add new master layouts to the deck.                                        |

## Organising

| Tool      | Description                              |
| --------- | ---------------------------------------- |
| `copy`    | Duplicate a slide or layout.             |
| `delete`  | Remove a slide or layout.                |
| `clear`   | Remove all slides or all unused layouts. |
| `reorder` | Move a slide to a new position.          |

## Reading & editing

| Tool         | Description                                                       |
| ------------ | ----------------------------------------------------------------- |
| `inspect`    | Get a manifest of the deck's slides or layouts.                   |
| `read`       | Read a slide, a layout, or the deck CSS as HTML.                  |
| `write`      | Replace the content of a slide, layout, or the CSS.               |
| `edit`       | Make targeted string-replacement edits in place.                  |
| `screenshot` | Render slides or layouts to PNG so the AI can check its own work. |

## Export

| Tool     | Description                                                                    |
| -------- | ------------------------------------------------------------------------------ |
| `export` | Produce the finished .pptx or PDF and get a download link (valid for 6 hours). |