PhotoForge MCP Server
Creates brand shoot entries and production briefs in Notion workspaces, allowing generated assets and notes to be organized into Notion pages.
Syncs editorial product imagery and generated assets directly into Shopify product listings, supporting ecommerce product content workflows.
Supports TikTok-oriented content workflows by generating viral captions and hashtag strategies, and by exporting creative assets to social channels.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PhotoForge MCP Server Generate a studio fashion photo of a model wearing a red dress"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π€ PhotoForge MCP Server β AI Fashion Studio, 4K Mocap Video & Creative Tools
Official Model Context Protocol (MCP) server for PhotoForge AI (https://photoforge.ai).
Enables AI agents (Claude Desktop, Cursor, Antigravity, Windsurf, Poe, etc.) to direct studio-grade fashion photoshoots, execute on-model garment try-ons, animate 4K kinematic video motion capture, perform background swaps, and publish directly to Shopify, Notion, and social channels.
β‘ Quick Start
1. Claude Desktop Configuration
Add the server definition to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"photoforge": {
"command": "npx",
"args": ["-y", "photoforge-mcp"],
"env": {
"PHOTOFORGE_MCP_API_KEY": "YOUR_PHOTOFORGE_API_KEY",
"PHOTOFORGE_SERVER_URL": "https://photoforge.ai"
}
}
}
}Or connect directly via local clone:
{
"mcpServers": {
"photoforge": {
"command": "node",
"args": ["/path/to/photoforge-mcp/index.js"],
"env": {
"PHOTOFORGE_MCP_API_KEY": "YOUR_PHOTOFORGE_API_KEY"
}
}
}
}2. Cursor Configuration (~/.cursor/mcp.json or Project Settings)
{
"mcpServers": {
"photoforge": {
"command": "node",
"args": ["/path/to/photoforge-mcp/index.js"],
"env": {
"PHOTOFORGE_MCP_API_KEY": "YOUR_PHOTOFORGE_API_KEY"
}
}
}
}3. Remote SSE Transport (No Local Install Required)
Connect your MCP client directly to the hosted Server-Sent Events endpoint:
Server URL:
https://photoforge.ai/api/mcpAuthentication:
Bearer YOUR_API_KEY(or?apiKey=user_...)
Get your API key at photoforge.ai/mcp (or use your Clerk User ID).
Related MCP server: ecommerce-3d-mcp
π οΈ Complete MCP Tools Catalog (28 Tools)
Tool | Category | Description | Key Parameters |
| Generation | Generates ultra-photorealistic studio fashion photography and portraits. |
|
| Editing | Replaces or synthesizes a new studio environment or scene backdrop. |
|
| Editing | Extracts subjects cleanly with transparent alpha masking. |
|
| Editing | Restores micro-textures and enhances resolution to 4K studio quality. |
|
| Video | Generates motion-captured 4K vertical runway and dance videos. |
|
| Video | Stitches multi-angle takes into commercial campaign sequences. |
|
| Video | Directs storyboard scenes, kinematic camera paths, and scripts. |
|
| Video | Introspects camera kinematics, sensor specs, and lens simulations. | (none) |
| Identity | Lists registered AI model digital twins and facial profiles. | (none) |
| Identity | Enrolls a new facial likeness profile for consistent model generation. |
|
| Identity | Removes an AI identity profile. |
|
| Packs | Catalogs 160+ curated photoshoot style packs. |
|
| Packs | Searches style recipes by aesthetic keywords or themes. |
|
| Packs | Matches optimal photography packs to target industry or niche. |
|
| Prompts | Converts rough concepts into studio-calibrated prompt directives. |
|
| Prompts | Recommends high-converting visual styles for target platforms. |
|
| Planning | Formulates editorial publishing calendars with photo/video briefs. |
|
| Assets | Synthesizes viral captions and hashtag strategies for TikTok, IG, LinkedIn. |
|
| Assets | Re-crops and frames assets for 9:16 vertical, 1:1 square, or 16:9 banner. |
|
| Connectors | Syncs editorial product imagery directly into Shopify product listings. |
|
| Connectors | Schedules or pushes creative assets to social platforms. |
|
| Connectors | Creates brand shoot entries and production briefs in Notion workspaces. |
|
| Connectors | Uploads and manages creator gallery drops on Fanvue. |
|
| Account | Checks remaining generation credits and quota. | (none) |
| Account | Returns active plan tier, licensing permissions, and renewal dates. | (none) |
| Workspace | Fetches historical generated assets and studio shoot metadata. |
|
| Workspace | Deletes an asset from the studio gallery. |
|
| Workspace | Favorites, stars, or renames gallery assets. |
|
π¦ MCP Resources & Prompts
Resources
photoforge://packsβ Complete catalog of 160+ photoshoot packs with prompts and categories.photoforge://stylesβ Studio lighting presets (Softbox, Golden Hour, Moody, Flash).photoforge://user/historyβ Authenticated user's recent studio generations and metadata.photoforge://user/identitiesβ Registered facial likeness models and digital twins.
Prompts
linkedin_executive_headshotβ 85mm f/1.4 studio portrait for executive profiles.luxury_travel_editorialβ High-fashion travel and destination photography.swaptok_video_cloneβ Dynamic 9:16 vertical video motion clone.ecommerce_product_shootβ Commercial product advertising photography.
π§ͺ Testing with MCP Inspector
Test the server locally in seconds:
npx @modelcontextprotocol/inspector node ./index.jsπ License
MIT License. See LICENSE for details.
Available Tools
28 toolschange_backgroundC
Swap or generate a new studio background for an existing image.
Inputs: imageUrl (required), backgroundPrompt (required), lightingMatch.
combine_videosC
Stitch and combine multiple video clips into a scene sequence.
Inputs: videoUrls (required), transitionType.
create_identityC
Create a new digital twin identity profile.
Inputs: name (required), faceImageUrl (required).
delete_generationC
Delete an image generation from the studio gallery.
Inputs: generationId (required).
delete_identityC
Delete a digital twin identity.
Inputs: identityId (required).
export_to_fanvueC
Export and publish AI creator assets to Fanvue.
Inputs: imageUrl (required), caption, isPaywalled.
export_to_notionB
Create a fashion shoot log or marketing brief in Notion.
Inputs: assetUrl (required), pageTitle (required), notes.
export_to_shopifyB
Export AI fashion and product photos directly to Shopify product listings.
Inputs: imageUrl (required), productTitle (required), description.
export_to_socialC
Export and schedule photos and videos to social platforms.
Inputs: assetUrl (required), caption, channels.
favorite_generationC
Toggle favorite status or rename an image generation.
Inputs: generationId (required), name, isFavorite.
film_studio_skillsB
List camera kinematics, motion capture specs, and lens simulations.
Inputs: no named parameters.
generate_captionB
Generate viral captions and hashtags tailored for Instagram, TikTok, or LinkedIn.
Inputs: imageDescription (required), platform.
generate_content_calendarB
Generate an editorial photo and video publishing calendar with prompt briefs.
Inputs: niche (required), month, frequency.
generate_photoC
Generate a high-quality realistic AI photo. Consumes 3 credits.
Inputs: prompt (required), pose, style, quality, +4 more.
generate_production_scriptC
Generate a full commercial video production script and storyboard sequence.
Inputs: concept (required), targetAudience, durationSeconds.
generate_videoC
Generate AI mocap or cinematic video from prompt or dance/runway reference.
Inputs: prompt (required), modelEngine, durationSeconds, referenceVideoUrl.
improve_promptC
Improve a basic user prompt into a high-converting, marketing-grade AI prompt.
Inputs: userPrompt (required), style.
list_generationsC
Retrieve recent AI generations created in the studio.
Inputs: limit, offset.
list_identitiesB
List user digital twins and facial identity profiles.
Inputs: no named parameters.
list_photo_packsA
List all available photo packs, categories, prices, and visual prompts.
Inputs: category.
recommend_photo_packB
Recommend the best photo packs for a given user objective or niche.
Inputs: goal (required), industry.
remaining_creditsB
Retrieve the users current remaining credit balance.
Inputs: no named parameters.
remove_backgroundA
Remove background from an image leaving transparent alpha channel.
Inputs: imageUrl (required).
resize_image_for_platformB
Resize and re-crop an image for specific social media aspect ratios.
Inputs: imageUrl (required), platform (required).
search_photo_packsC
Search for photo packs matching a query string.
Inputs: query (required).
subscription_statusA
Retrieve the active subscription status and renewal date for the user.
Inputs: no named parameters.
suggest_stylesC
Suggest popular visual styles and rendering qualities for a prompt type.
Inputs: category (required).
upscale_photoB
AI-upscale photo to 4K resolution with micro-texture restoration.
Inputs: imageUrl (required), scaleFactor.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 28 tools
Most tools target distinct resources or actions, such as generation vs. background editing vs. exporting. A few areas could still be confused, especially recommend_photo_pack versus list_photo_packs/search_photo_packs and the multiple prompt/content helpers, but descriptions generally clarify boundaries.
The set is mostly consistent snake_case with verb_noun or verb_to_noun patterns like generate_photo, change_background, and export_to_shopify. Deviations such as remaining_credits, subscription_status, and film_studio_skills are minor but noticeable.
At 28 tools, the surface exceeds the 25+ threshold for being too many under the rubric. The server has broad scope across generation, editing, exports, identities, photo packs, and account management, but the count still feels heavy for an agent to navigate efficiently.
Core workflows are well covered: prompt improvement, photo/video generation, image editing, exports, credits/subscription, identities, and photo packs. Minor lifecycle gaps remain, such as no explicit get/update for identities and limited retrieval/update coverage for generations and videos.
Maintenance
Related MCP Connectors
Build and run AI product photography workflows: on-model shots, catalog images, prints and edits.
Virtual try-on and on-model AI fashion photography: catalog search, try-on grids, HD delivery.
Create product photos, on-model images, ad visuals and short videos from one product photo.
On-brand creative studio for AI agents: images, video, audio, and 3D.
Related MCP Servers
AlicenseAqualityAmaintenanceEnables AI agents to create, manage, and download 3D models, textures, images, rigged characters, and animations through natural conversation.2837,042 npm93MIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to generate 3D product viewers, AR try-on experiences, Shopify integrations, and SEO metadata for e-commerce stores.30 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to act as graphic designers by generating images and social-ready visuals, with brand DNA memory, genre-aware styles, 35+ platform presets, self-critique, and version control.MIT

fashio-mcpofficial
AlicenseAqualityCmaintenanceLets MCP-capable agents such as Claude and Cursor call the Fashio API to generate on-model fashion photos, virtual try-ons, catalog packs, background removal, upscaling, and more as tool calls.1416 npmMIT