# Pruna Mcp Server

> MCP server for Pruna AI — ultra-fast image generation, editing, upscaling, and video generation

- **Type:** MCP server
- **Install:** `agentstack add mcp-charlesrapp-pruna-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [charlesrapp](https://agentstack.voostack.com/s/charlesrapp)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [charlesrapp](https://github.com/charlesrapp)
- **Source:** https://github.com/charlesrapp/pruna-mcp-server

## Install

```sh
agentstack add mcp-charlesrapp-pruna-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🎨 pruna-mcp-server

[](https://github.com/charlesrapp/pruna-mcp-server/actions/workflows/ci.yml)
[](https://pypi.org/project/pruna-mcp-server/)
[](https://pypi.org/project/pruna-mcp-server/)
[](https://opensource.org/licenses/MIT)

MCP server for [Pruna AI](https://pruna.ai) — ultra-fast image generation, editing, upscaling, and video generation directly from your AI assistant.

[Pruna AI](https://pruna.ai) is an inference API specialized in image and video generation. It offers sub-2-second image generation starting at $0.005/image, with models for text-to-image, image editing, upscaling, and video generation. This MCP server wraps their API so any MCP-compatible client (Claude Desktop, Kiro, Cursor) can generate visual content natively.

Conforms to [MCP Specification 2025-11-25](https://modelcontextprotocol.io/specification/2025-11-25).

## Features

- **8 MCP Tools**: `generate_image`, `edit_image`, `try_on_image`, `upscale_image`, `generate_video`, `transform_video`, `list_models`, `upload_file`
- **7 MCP Prompts**: Product photos, virtual staging, social media visuals, game concept art, ad creatives, video ads, image enhancement
- **2 MCP Resources**: `pruna://models` catalog for model discovery without tool calls
- **21 models**: 10 text-to-image, 3 editing, 1 virtual try-on, 1 upscale, 4 video, 2 video-to-video
- **Smart sync/async**: Sync for fast image models, async with polling for video
- **Transparent file handling**: Pass local paths or URLs — auto-upload handled
- **Native MCP image return**: `ImageContent` blocks for clients that support inline display
- **Full MCP compliance**: Tool annotations, structured content, progress notifications

## Quick Start

```bash
# With uvx (zero install)
uvx pruna-mcp-server

# Or with pip
pip install pruna-mcp-server
pruna-mcp
```

Set your API key — get one at [pruna.ai](https://pruna.ai) (go to the [developer portal](https://docs.api.pruna.ai/) or [contact Pruna](https://pruna.ai/contact) to request access):

```bash
# macOS Keychain (recommended)
security add-generic-password -a $USER -s PRUNA_API_KEY -w "your-api-key"

# Linux (GNOME Keyring)
secret-tool store --label="Pruna API Key" service pruna-mcp-server key api_key  **Note**: Kiro agents use a `tools` whitelist with `@server-name/*` syntax and an `allowedTools` list. Both must include the Pruna tools for them to be available.

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "pruna": {
      "command": "sh",
      "args": ["-c", "PRUNA_API_KEY=$(security find-generic-password -a $USER -s PRUNA_API_KEY -w) /path/to/uv run --directory /path/to/pruna-mcp-server pruna-mcp"]
    }
  }
}
```

> **Important**: Use the full path to `uv` (e.g. `/Users/you/.local/bin/uv`) — Claude Desktop launches processes with a minimal PATH that doesn't include `~/.local/bin`.

> **Note**: Claude Desktop does not render `ImageContent` inline in the chat. The image is generated and saved locally — Claude will reference the file path in its response.

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "pruna": {
      "command": "uvx",
      "args": ["pruna-mcp-server"],
      "env": { "PRUNA_API_KEY": "your-api-key" }
    }
  }
}
```

## Tools

| Tool | Description | Pricing |
|------|-------------|---------|
| `generate_image` | Text-to-image with 10 models | From $0.0001/image |
| `edit_image` | Edit 1-5 images with text instructions | From $0.010/image |
| `try_on_image` | Virtual try-on: fit up to 11 garments onto a person | $0.015 first + $0.008/extra garment |
| `upscale_image` | AI upscaling up to 128 megapixels | From $0.005/image |
| `generate_video` | Text/image/audio to video | From $0.005/s |
| `transform_video` | Video-to-video: animate a subject or replace characters | $0.03/s (720p), $0.06/s (1080p) |
| `list_models` | Browse all available models with pricing | Free |
| `upload_file` | Upload files for editing/video workflows | Free |

Image tools return both a JSON metadata block and a native MCP `ImageContent` block (base64, for images < 5MB).

## Prompts

Built-in workflow templates for common use cases:

| Prompt | Use Case | Example |
|--------|----------|---------|
| `product-photo` | E-commerce product shots | "white leather sneakers on clean background" |
| `virtual-staging` | Real estate room staging | Stage empty rooms with furniture |
| `social-media-visual` | Platform-optimized visuals | Auto aspect ratio per platform |
| `game-concept-art` | Game assets & environments | Characters, weapons, landscapes |
| `ad-creative` | Digital ads with text overlay | Headlines rendered in the image |
| `video-ad` | Short video ads | Talking heads, product demos |
| `image-enhance` | Upscale + enhance workflow | AI-generated image refinement |

## Configuration

| Environment Variable | Required | Default | Description |
|---------------------|----------|---------|-------------|
| `PRUNA_API_KEY` | ✅ | — | Your Pruna AI API key |
| `PRUNA_OUTPUT_DIR` | — | `./pruna-output` | Directory for downloaded files |
| `PRUNA_POLL_INTERVAL` | — | `2` | Seconds between async polls |
| `PRUNA_TIMEOUT` | — | `120` | HTTP timeout in seconds |
| `PRUNA_MAX_RETRIES` | — | `3` | Max retries on transient errors |

## Client Compatibility

| Client | Transport | Status | Notes |
|--------|-----------|--------|-------|
| Kiro CLI | STDIO | ✅ Tested | Requires `tools` + `allowedTools` config |
| Claude Desktop | STDIO | ✅ Tested | Use full path to `uv`; no inline image display |
| Cursor | STDIO | 🔲 Planned | — |
| Claude Code | STDIO | 🔲 Planned | — |

## Development

```bash
git clone https://github.com/charlesrapp/pruna-mcp-server.git
cd pruna-mcp-server
uv sync --extra dev

# Run tests (147 tests, 97% coverage)
uv run pytest --cov

# Lint & type check
uv run ruff check src/ tests/
uv run mypy src/
```

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT — see [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [charlesrapp](https://github.com/charlesrapp)
- **Source:** [charlesrapp/pruna-mcp-server](https://github.com/charlesrapp/pruna-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-charlesrapp-pruna-mcp-server
- Seller: https://agentstack.voostack.com/s/charlesrapp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.