# Perizent MCP server: Persian PowerPoint from Claude, Cursor and any MCP client

[Perizent](https://perizent.ir) builds editable, right-to-left **Persian (Farsi) PowerPoint** decks with AI. This repository documents its hosted **MCP server**, so you can ask Claude, Cursor or any MCP client: *"build a 10-slide Persian deck about …"* and get PPTX and PDF links back.

- **Endpoint:** `https://perizent.ir/api/mcp` (Streamable HTTP, stateless)
- **Auth:** `Authorization: Bearer <key>`. Create your key at [perizent.ir/mcp](https://perizent.ir/mcp) (Pro and Business plans). For clients that cannot send headers: `https://perizent.ir/api/mcp?key=<key>`
- **Registry name:** `io.github.ablmontazer1997/perizent` ([server.json](server.json))

The server is hosted; there is nothing to install or run locally. This repo holds the connection docs, examples and the registry manifest.

## Connect

**Claude Code**
```bash
claude mcp add --transport http perizent https://perizent.ir/api/mcp \
  --header "Authorization: Bearer YOUR_PERIZENT_KEY"
```

**Cursor** (`~/.cursor/mcp.json`)
```json
{ "mcpServers": { "perizent": { "url": "https://perizent.ir/api/mcp", "headers": { "Authorization": "Bearer YOUR_PERIZENT_KEY" } } } }
```

**Claude Desktop** (`claude_desktop_config.json`, through `mcp-remote`)
```json
{ "mcpServers": { "perizent": { "command": "npx", "args": ["-y", "mcp-remote", "https://perizent.ir/api/mcp", "--header", "Authorization: Bearer YOUR_PERIZENT_KEY"] } } }
```

**claude.ai** (Settings → Connectors → Add custom connector): `https://perizent.ir/api/mcp?key=YOUR_PERIZENT_KEY`

## Tools

| Tool | What it does |
|---|---|
| `list_design_options` | Themes, fonts, icon packs, animation levels, image styles, audiences and goals, with the ids the other tools accept |
| `create_presentation` | Starts a deck from a topic (`topic`), full text (`full_text`) or rough notes (`partial_text`); slide count, audience, goal, theme, font, icons, animation, image style, brand name and logo. Returns a `job_id` right away |
| `get_presentation` | Status of a job; when `done`, links to the PPTX, the PDF and slide previews (valid for 7 days) |
| `restyle_presentation` | Changes the theme, font, icons, animation, image style or brand of a finished deck in seconds, without rewriting the content |
| `share_presentation` | Creates, updates or revokes the public online-presentation link of a deck, with optional password and viewer downloads |
| `list_presentations` | Decks created with your key |
| `account_info` | Plan, credits and usage |
| `set_defaults` | Changes the account defaults for new decks: animation level and image style |

A deck usually takes 1 to 3 minutes. Each key only sees its own decks. Download links are signed and expire after 7 days.

## What you get

- Right-to-left layout, correct Persian letter shaping, half-spaces (ZWNJ) and Persian digits
- 100 designs and 8 Persian fonts
- In topic mode, web search for up-to-date numbers, with source footnotes
- Charts, tables and infographics
- Editable PPTX and PDF output

How well AI slide tools handle Persian is measured in an open benchmark: [paper (DOI 10.5281/zenodo.23976939)](https://doi.org/10.5281/zenodo.23976939), [dataset on Hugging Face](https://huggingface.co/datasets/ablmontazer/persian-ai-slide-benchmark).

---

## فارسی

پریزنت سرویس ساخت پاورپوینت فارسی با هوش مصنوعی است. با این سرور MCP می‌توانی از داخل Claude، Cursor یا هر کلاینت MCP بگویی «یک ارائه ۱۰ اسلایدی درباره … بساز» و لینک PPTX و PDF راست‌چین و ویرایش‌پذیر تحویل بگیری.

- نشانی: `https://perizent.ir/api/mcp`
- کلید شخصی را از [perizent.ir/mcp](https://perizent.ir/mcp) بساز (پلن حرفه‌ای و سازمانی) و در هدر `Authorization: Bearer <کلید>` بگذار.
- نمونه تنظیم هر کلاینت در پوشه [examples](examples) است.

## License

MIT for the docs and examples in this repository. Perizent itself is a commercial service: [perizent.ir](https://perizent.ir).