Photo AI Studio MCP Server
AI photo generation, editing, and video creation MCP server for Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
Generate professional AI headshots, edit photos with 19 AI operations, and create AI videos, all from your AI assistant.
Powered by Photo AI Studio.
Website • Get API Key • Pricing • npm
What Can You Do?
Ask your AI assistant things like:
- "Upload my photo and generate a professional headshot"
- "Remove the background from this image"
- "Make me look 10 years younger in this photo"
- "Change my hairstyle to curly blonde"
- "Swap my face onto this photo"
- "Upscale this image to higher resolution"
- "Create a video from this image with cinematic motion"
- "Show me available photo themes for women"
Quick Start
1. Create a Free Account
Sign up at photoaistudio.com — new accounts get 100 free credits.
2. Get an API Key
Go to photoaistudio.com/api-keys to create your API key.
3. Configure Your AI Assistant
Claude Desktop (~/.claude/settings.json):
{
"mcpServers": {
"photoaistudio": {
"command": "npx",
"args": ["-y", "@photoaistudio/mcp-server"],
"env": {
"PHOTOAI_API_KEY": "pa_sk_your-key-here"
}
}
}
}
Cursor: Add the same config in Cursor Settings > MCP Servers.
Windsurf / VS Code Copilot: Add to your MCP configuration file.
Available Tools
Photo Generation
| Tool | Description | Credits |
|---|---|---|
generate_photo |
Generate AI photos from face images using 150+ themed styles or custom prompts | 100/photo |
browse_themes |
Browse all available photo themes, filter by gender or search by keyword | Free |
Photo Editing
| Tool | Description | Credits |
|---|---|---|
edit_image |
19 AI-powered edit operations (see list below) | 3-100 |
Edit operations: remove_background (10 cr), replace_background (3 cr), retouch, skin, hair, makeup, age, expression, body_type, eye_color, color_correction, custom, clothes, try_on, product, upscale, restore, face_swap, extend (100 cr each)
Video Creation
| Tool | Description | Credits |
|---|---|---|
create_video |
Create AI videos from images | 100-500 |
Video types: image_to_video (500 cr) — animate any photo, ugc (500 cr) — AI-generated spokesperson videos, product_holder (500 cr video / 100 cr image) — product showcase
Utilities
| Tool | Description | Credits |
|---|---|---|
upload_image |
Upload an image (URL or base64) to the CDN for use in other tools | Free |
get_account |
Check your credit balance and account info | Free |
get_prediction |
Check the status of an async operation | Free |
list_predictions |
List your past generations, edits, and videos | Free |
How It Works
1. Upload your photo → upload_image (returns CDN URL)
2. Browse available styles → browse_themes (150+ options)
3. Generate AI photos → generate_photo (auto-waits for result)
4. Or edit your photo → edit_image (19 operations available)
5. Results returned directly → Auto-polls until complete
All operations are async but auto-poll by default — the tool waits and returns the final result URL. Set wait_for_result: false to get the prediction ID immediately for manual polling.
Credits and Pricing
New accounts start with 100 free credits.
| Package | Price | |
|---|---|---|
| 500 credits | $9 | Buy |
| 1,000 credits | $17 | Buy |
| 2,000 credits | $25 | Buy |
| 4,000 credits | $35 | Buy |
| 8,000 credits | $80 | Buy |
| 20,000 credits | $190 | Buy |
Monthly subscriptions also available at photoaistudio.com/pricing.
Environment Variables
| Variable | Required | Description |
|---|---|---|
PHOTOAI_API_KEY |
Yes | Your API key from photoaistudio.com/api-keys |
PHOTOAI_BASE_URL |
No | API base URL (default: https://photoaistudio.com) |
Examples
Generate a Professional Headshot
User: "Upload this photo and generate a professional headshot"
1. upload_image → CDN URL
2. browse_themes (gender: "female", tag: "professional") → theme slug
3. generate_photo (images: [CDN URL], gender: "female", category: "professional") → result URL
Remove Background
User: "Remove the background from this image"
1. upload_image → CDN URL
2. edit_image (operation: "remove_background", image_url: CDN URL) → result URL
Face Swap
User: "Swap my face onto this celebrity photo"
1. upload_image (source face) → source CDN URL
2. upload_image (target photo) → target CDN URL
3. edit_image (operation: "face_swap", source_image_url, target_image_url) → result URL
Tech Stack
- TypeScript
- Model Context Protocol SDK
- stdio transport (runs locally, calls Photo AI Studio API over HTTPS)
Links
- Photo AI Studio — Main website
- API Keys — Create and manage API keys
- Pricing — Credit packages and subscriptions
- Photo Themes — Browse 150+ AI photo styles
- npm Package
License
MIT