npm package: @photoaistudio/mcp-server
Description: MCP server for Photo AI Studio — AI photo generation, editing, and video creation for Claude Desktop, Cursor, and other MCP clients
Latest version: 1.0.1

# @photoaistudio/mcp-server

MCP server for [Photo AI Studio](https://photoaistudio.com) — AI photo generation, editing, and video creation for Claude Desktop, Cursor, Windsurf, and other MCP clients.

Transform your photos with 150+ AI styles, edit with 19 AI-powered operations, and create videos, all from your AI assistant.

## Quick Start

### 1. Create a Free Account

Sign up at [photoaistudio.com](https://photoaistudio.com) — new accounts get **100 free credits** to start.

### 2. Get an API Key

Go to [Dashboard > API Keys](https://photoaistudio.com/api-keys) to create your key.

### 3. Configure Your AI Assistant

Add this to your MCP client configuration:

**Claude Desktop** (`~/.claude/settings.json` or Claude Desktop settings):

```json
{
  "mcpServers": {
    "photoaistudio": {
      "command": "npx",
      "args": ["-y", "@photoaistudio/mcp-server"],
      "env": {
        "PHOTOAI_API_KEY": "pa_sk_your-key-here"
      }
    }
  }
}
```

**Cursor / Windsurf / VS Code Copilot**: Add the same configuration in your MCP settings.

### 4. Start Using It

Ask your AI assistant things like:

- "Upload my photo and generate a professional headshot"
- "Remove the background from this image"
- "Show me available photo themes for women"
- "Upscale this photo to higher resolution"
- "Create a video from this image"
- "Check my credit balance"

## Available Tools

| Tool | Description | Credits |
|------|-------------|---------|
| `get_account` | Check credit balance and account info | Free |
| `browse_themes` | Browse [150+ photo themes](https://photoaistudio.com/s/all) by gender/tag | Free |
| `upload_image` | Upload image (URL or base64) to CDN | Free |
| `generate_photo` | Generate AI photos from face images | 100/photo |
| `edit_image` | 19 edit operations (remove bg, retouch, upscale, face swap, etc.) | 3-100 |
| `create_video` | Create AI videos (animate, UGC, product showcase) | 100-500 |
| `get_prediction` | Check async operation status | Free |
| `list_predictions` | List past predictions | Free |

### 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 Types

`image_to_video` (500 cr), `ugc` (500 cr), `product_holder` (500 cr video / 100 cr image)

## Credits & Pricing

New accounts start with **100 free credits**. Purchase more at [photoaistudio.com/pricing](https://photoaistudio.com/pricing):

| Package | Price |
|---------|-------|
| 500 credits | $9 |
| 1,000 credits | $17 |
| 2,000 credits | $25 |
| 4,000 credits | $35 |
| 8,000 credits | $80 |
| 20,000 credits | $190 |

Monthly subscriptions are also available at [photoaistudio.com/pricing](https://photoaistudio.com/pricing).

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `PHOTOAI_API_KEY` | Yes | Your API key from [Dashboard > API Keys](https://photoaistudio.com/api-keys) |
| `PHOTOAI_BASE_URL` | No | API base URL (default: `https://photoaistudio.com`) |

## How It Works

1. **Upload** your photo using `upload_image` to get a CDN URL
2. **Browse** available styles with `browse_themes`
3. **Generate** AI photos with `generate_photo`, or **edit** with `edit_image`
4. Results are returned automatically (auto-polls until complete)

All operations use credits from your [Photo AI Studio](https://photoaistudio.com) account.

## Links

- [Photo AI Studio](https://photoaistudio.com) — Main website
- [Dashboard](https://photoaistudio.com/dashboard) — Manage your account
- [API Keys](https://photoaistudio.com/api-keys) — Create and manage API keys
- [Pricing](https://photoaistudio.com/pricing) — Credit packages and subscriptions
- [Photo Themes](https://photoaistudio.com/s/all) — Browse all 150+ AI photo styles

## License

MIT