io.github.RyanKramer/pixelpanda-mcp
33 image tools: free local editing, AI upscaling, background removal, and product photos
Open source Open in the app JSON README (API)
About
33 image tools: free local editing, AI upscaling, background removal, and product photos
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- ryankramer
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Stars
- 21
- Forks
- 5
- Last push
- 2026-08-27T02:19:27Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 03:02:13
- Updated
- 2026-08-29 03:02:13
- Origin id
io.github.RyanKramer/pixelpanda-mcp
README
<!-- mcp-name: io.github.RyanKramer/pixelpanda-mcp -->
# PixelPanda MCP Server
AI image processing tools for Claude Desktop, Cursor, VS Code, and other MCP-compatible clients.
**38 tools** across three tiers — from free local image editing to AI-powered product photography.
## Install
```bash
# Using uv (recommended)
uvx pixelpanda-mcp
# Or pip
pip install pixelpanda-mcp
```
## Setup
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"pixelpanda": {
"command": "uvx",
"args": ["pixelpanda-mcp"],
"env": {
"PIXELPANDA_API_TOKEN": "pk_live_your_token_here"
}
}
}
}
```
### Cursor
Add to your MCP settings (Settings > MCP Servers):
```json
{
"pixelpanda": {
"command": "uvx",
"args": ["pixelpanda-mcp"],
"env": {
"PIXELPANDA_API_TOKEN": "pk_live_your_token_here"
}
}
}
```
> The API token is **optional** — all local and free AI tools work without it. You only need a token for paid generation tools.
## Tools
### Local Tools (free, no account needed, runs offline)
| Tool | Description |
|------|-------------|
| `resize_image` | Resize with optional aspect ratio preservation |
| `crop_image` | Crop to specific pixel coordinates |
| `rotate_image` | Rotate by any degree |
| `flip_image` | Flip horizontal or vertical |
| `grayscale_image` | Convert to grayscale |
| `invert_image` | Invert colors (negative) |
| `round_corners` | Round corners with custom radius |
| `add_border` | Add solid color border |
| `compress_image` | Compress to JPEG/WebP with quality control |
| `merge_images` | Merge multiple images (horizontal/vertical/grid) |
| `convert_format` | Convert between PNG, JPEG, WebP, BMP, TIFF |
| `make_transparent` | Adjust image opacity |
| `create_profile_picture` | Circle/square/rounded profile picture |
| `blur_image` | Gaussian blur |
| `adjust_image` | Brightness, contrast, sharpness, saturation |
| `add_watermark` | Text watermark (center/corner/tiled) |
| `pixelate_image` | Pixelation effect |
| `get_image_info` | Dimensions, format, file size, DPI, color mode |
### AI Tools (free, 3 uses/day)
| Tool | Description |
|------|-------------|
| `remove_background` | AI background removal (transparent PNG) |
| `upscale_image` | AI upscaling 2x or 4x (Real-ESRGAN) |
| `remove_text` | AI text/watermark removal (OCR + inpainting) |
| `analyze_image` | AI image analysis (objects, colors, composition, quality) |
### Pro Tools (paid, 1 credit/image)
| Tool | Credits | Description |
|------|---------|-------------|
| `check_credits` | 0 | Check your credit balance |
| `list_avatars` | 0 | List your AI avatars |
| `list_products` | 0 | List your uploaded products |
| `upload_product` | 0 | Upload a product image |
| `generate_product_photo` | 1/image | AI product photos with avatar |
| `generate_tryon` | 1/image | AI try-on (avatar wearing product) |
| `generate_scenes` | 1/scene | AI product scenes (studio, lifestyle) |
| `image_to_prompt` | 1 | Reverse-engineer an image into Midjourney/Flux/SD prompts |
| `edit_image` | 2 | Text-prompt image editing (FLUX Kontext Pro) |
| `generate_avatar` | 1/avatar | Create reusable AI characters (guided or from a reference photo) |
| `check_avatar_status` | 0 | Poll an avatar generation job |
| `generate_video` | 50 | UGC video from a still image — Grok Imagine, native audio + lip-sync |
| `check_video_status` | 0 | Poll a video generation job |
| `check_job_status` | 0 | Check generation progress |
| `list_jobs` | 0 | List recent generation jobs |
## Pricing
- **Free**: All local tools + 3 AI tool uses/day on /free-tools/*
- **$10 one-time**: 50 credits for pro tools (no subscription, credits never expire)
- **$24/mo Starter**: 1,125 credits/month — best value for regular use
Get your API token at [pixelpanda.ai/pricing](https://pixelpanda.ai/pricing)
## Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| `PIXELPANDA_API_TOKEN` | For pro tools | Your API token (`pk_live_...`) |
| `PIXELPANDA_API_URL` | No | API base URL (default: `https://pixelpanda.ai`) |
## Examples
```
"Resize photo.jpg to 800px wide"
"Remove the background from product.png"
"Upscale this image 4x"
"Merge these 3 screenshots horizontally"
"Generate 6 product photos using avatar abc123 and product def456"
```
## License
MIT