Skip to main content
Glama

πŸ€– PhotoForge MCP Server β€” AI Fashion Studio, 4K Mocap Video & Creative Tools

MCP License: MIT Tools Claude Desktop Cursor

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.json

  • Windows: %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/mcp

  • Authentication: 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

generate_photo

Generation

Generates ultra-photorealistic studio fashion photography and portraits.

prompt, userImage, style, lighting, pose, background, quality

change_background

Editing

Replaces or synthesizes a new studio environment or scene backdrop.

imageUrl, backgroundPrompt, lightingMatch

remove_background

Editing

Extracts subjects cleanly with transparent alpha masking.

imageUrl

upscale_photo

Editing

Restores micro-textures and enhances resolution to 4K studio quality.

imageUrl, scaleFactor

generate_video

Video

Generates motion-captured 4K vertical runway and dance videos.

prompt, referenceVideoUrl, modelEngine, durationSeconds

combine_videos

Video

Stitches multi-angle takes into commercial campaign sequences.

videoUrls, transitionType

generate_production_script

Video

Directs storyboard scenes, kinematic camera paths, and scripts.

concept, targetAudience, durationSeconds

film_studio_skills

Video

Introspects camera kinematics, sensor specs, and lens simulations.

(none)

list_identities

Identity

Lists registered AI model digital twins and facial profiles.

(none)

create_identity

Identity

Enrolls a new facial likeness profile for consistent model generation.

name, faceImageUrl

delete_identity

Identity

Removes an AI identity profile.

identityId

list_photo_packs

Packs

Catalogs 160+ curated photoshoot style packs.

category

search_photo_packs

Packs

Searches style recipes by aesthetic keywords or themes.

query

recommend_photo_pack

Packs

Matches optimal photography packs to target industry or niche.

goal, industry

improve_prompt

Prompts

Converts rough concepts into studio-calibrated prompt directives.

userPrompt, style

suggest_styles

Prompts

Recommends high-converting visual styles for target platforms.

category

generate_content_calendar

Planning

Formulates editorial publishing calendars with photo/video briefs.

niche, frequency, month

generate_caption

Assets

Synthesizes viral captions and hashtag strategies for TikTok, IG, LinkedIn.

imageDescription, platform

resize_image_for_platform

Assets

Re-crops and frames assets for 9:16 vertical, 1:1 square, or 16:9 banner.

imageUrl, platform

export_to_shopify

Connectors

Syncs editorial product imagery directly into Shopify product listings.

imageUrl, productTitle, description

export_to_social

Connectors

Schedules or pushes creative assets to social platforms.

assetUrl, caption, channels

export_to_notion

Connectors

Creates brand shoot entries and production briefs in Notion workspaces.

assetUrl, pageTitle, notes

export_to_fanvue

Connectors

Uploads and manages creator gallery drops on Fanvue.

imageUrl, caption, isPaywalled

remaining_credits

Account

Checks remaining generation credits and quota.

(none)

subscription_status

Account

Returns active plan tier, licensing permissions, and renewal dates.

(none)

list_generations

Workspace

Fetches historical generated assets and studio shoot metadata.

limit, offset

delete_generation

Workspace

Deletes an asset from the studio gallery.

generationId

favorite_generation

Workspace

Favorites, stars, or renames gallery assets.

generationId, name, isFavorite


πŸ“¦ 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 tools
change_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

    B3.1/5.0

    Scored across 28 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Enables AI agents to create, manage, and download 3D models, textures, images, rigged characters, and animations through natural conversation.
      28
      37,042 npm
      93
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Lets 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.
      14
      16 npm
      MIT