Official Model Context Protocol Server

AI Product Photography Inside Claude, Cursor & AI Agents

Automate catalog upscaling, check credit balances, and generate Amazon-ready 4K product photos straight from your IDE or conversational AI assistant.

1-Minute Configuration

Select your client to copy the exact launch snippet. Runs locally via standard stdio JSON-RPC.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json | Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "productimageupscale": {
      "command": "npx",
      "args": ["-y", "productimageupscale-mcp@latest"],
      "env": {
        "PRODUCTIMAGEUPSCALE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Exposed MCP Tools

All tools authenticate securely via your server-level PRODUCTIMAGEUPSCALE_API_KEY environment variable.

upscale_image

Upscales an e-commerce product photo to high resolution (2x, 4x, or 8x) while preserving fine typography, fabric weaves, metallic highlights, and logos without AI hallucination. Automatically downloads the upscaled image directly to your local computer (persisting the temporary 1-hour GPU CDN URL to disk). Costs 1 credit per image.

Parameters
imageUrlstring (URL)Required
Public HTTPS URL of the image (JPEG, PNG, WebP). Animated GIFs are strictly unsupported.
scale"2" | "4" | "8"Optional
Scaling multiplier. 2x doubles resolution (default: 2), 4x quadruples, 8x for maximum resolution.
materialTypeenumOptional
Processing mode: general (standard e-commerce product packshot), model (activates AI face enhancement for lifestyle photos), fabric, or leather. Default: general.
outputPathstring (path)Optional
Optional local directory or file path to save the upscaled image (e.g. "~/Downloads/ProductImageUpscale" or "./assets/shoe.png"). Defaults to ~/Downloads/ProductImageUpscale.
autoDownloadbooleanOptional
Automatically download and save the upscaled image directly to your local computer. Default: true (persists the temporary 1-hour CDN link). Set false for URL-only pipelines.
check_credits

Inspects live credit balance, active subscription tier (Free, Starter, Pro), and storage quota utilization.

check_upscale_status

Polls the status of an asynchronous GPU processing job using the imageId returned when upscale_image queues a request. Automatically downloads the completed image directly to your computer upon success to persist the temporary 1-hour CDN link.

Parameters
imageIdstringRequired
Job ID received from an asynchronous upscale request.
outputPathstring (path)Optional
Optional local directory or file path to save the completed image upon success. Defaults to ~/Downloads/ProductImageUpscale.
autoDownloadbooleanOptional
Automatically download and save the completed image directly to your local computer upon success. Default: true.
list_material_types

Returns the catalog of processing modes (standard vs. face enhancement) and category presets.

Automatic Local File Saving & Dedicated Directory UX

Upscaled images download directly to your local computer with zero clutter and collision-safe naming.

Dedicated Subfolder

Files default to ~/Downloads/ProductImageUpscale/ instead of dumping into your root Downloads folder.

Whether processing 1 image or 100 catalog photos, your personal downloads stay completely clean and organized.

Collision-Safe Naming

Never accidentally overwrites existing files. If item-upscaled-2x.png exists, subsequent files automatically increment to -1.png, -2.png.

Safe for repetitive batch catalogs and multi-angle product photography runs.

Custom Destination

Pass outputPath or tell your agent: “save upscaled photos to ./public/products”.

Writes directly into your active project codebase, Shopify theme directory, or static asset repository.

Important: Temporary 1-Hour CDN Links — Why Auto-Download Is CriticalThe output URLs generated by the AI upscaling engine (outputUrl) are ephemeral GPU delivery links that expire after just 1 hour. They must never be hotlinked directly on live Shopify, WooCommerce, or Amazon product listings. By automatically saving upscaled images directly to your machine or project directory, your high-resolution assets are permanently preserved for production.
Cross-platform standard: macOS (~/Downloads/ProductImageUpscale), Windows (Downloads\ProductImageUpscale), LinuxHeadless pipelines: set autoDownload: false for URL-only output

Processing Modes & Category Presets

Pass materialType to switch between standard e-commerce super-resolution and AI face restoration for human models.

general
Recommended

Standard Product (Default)

The primary super-resolution engine for all e-commerce product packshots (shoes, electronics, cosmetics, jewelry, toys, home goods). Preserves crisp typography, logos, and edge geometry.

Real-ESRGAN edge-preserving super-resolution
model
Face Restoration

Model & Lifestyle (Face Enhancement)

Activates specialized AI facial reconstruction for lifestyle photos featuring human models and portraits wearing apparel (GFPGAN enabled at 2x and 4x; auto-disabled at 8x).

Real-ESRGAN + GFPGAN AI face restoration
fabric
Category Preset

Fabric & Apparel (Category Preset)

Convenient category alias for clothing, garments, and soft goods catalogs. Runs the standard super-resolution engine with apparel defaults.

Standard super-resolution (tuned for apparel packshots)
leather
Category Preset

Leather Goods (Category Preset)

Convenient category alias for footwear, bags, belts, and leather accessories. Runs the standard super-resolution engine with leather goods defaults.

Standard super-resolution (tuned for leather accessories)

MCP Resources

Resources provide direct contextual read access to your account data and compliance documentation.

  • account://balanceLive JSON payload returning remaining credits, tier, and storage metrics.
  • docs://api-guideFull specifications for Amazon (1,600px zoom), Shopify (2,048px square), and format support.

Guided MCP Prompts

Pre-engineered agent prompt templates for automated workflows with balance protection.

  • upscale-product-imageStep-by-step single-product workflow: checks balance → chooses optimal preset → upscales → confirms resolution.
  • batch-upscale-catalogMulti-product catalog pipeline with pre-execution credit checks and markdown before/after tables.

Example AI Agent Prompts

Copy and paste these exact workflows into Claude Desktop, Cursor, or your autonomous AI agent.

Single Image Upscale with Model Preset

Instruct Claude or Cursor to inspect balance, upscale an on-model lifestyle photo with AI face enhancement, and save locally.

“Check my ProductImageUpscale credit balance first. If I have credits remaining, upscale this lifestyle apparel photo using the model preset: https://example.com/products/model-hoodie.png. Save the result to my computer and confirm the local file path.”

Multi-Product Catalog Batch Workflow

Automate catalog enhancements while saving all images directly to a local project directory.

“I have 3 new apparel items to publish. Verify I have enough credits, then upscale each item at 2x with the fabric preset and save them directly to my "./public/products" folder:
1. https://example.com/coat-1.jpg
2. https://example.com/dress-2.jpg
3. https://example.com/shirt-3.jpg
Summarize the local paths in a table.”

Marketplace Zoom Compliance Check

Ensure uploaded assets meet Amazon 1,600 px zoom and Shopify square catalog guidelines.

“Upscale this product packshot to 4x using ProductImageUpscale AI. Save it to ~/Downloads/ProductImageUpscale and confirm whether the resulting output meets Amazon’s 1,600px minimum zoom requirement.”

Transparent Credit Economics

Every image upscale consumes 1 credit regardless of scale factor (2x, 4x, or 8x). No hidden GPU minute charges.

PlanPriceMonthly CreditsUnit PriceStorage QuotaRetention
Free$05 credits / moFree100 MB30-day rolling
Starter$9 / mo200 credits / mo$0.045 / upscale500 MBPermanent
Pro$19 / mo2,000 credits / mo< $0.01 / upscale2 GBPermanent
Non-Expiring Top-Up Packs (Subscribers): 100 credits for $15 ($0.15/credit) • 500 credits for $35 ($0.07/credit — Save 53%).View Full Pricing Details →

Security & Gating Architecture

Prompt-Injection Immune

Identity is never extracted from prompt parameters. The API key is set strictly as an environment variable at server launch.

Automated Format Guard

Animated GIFs and malformed headers are intercepted before reaching the GPU, preventing crashes and saving API credits.

Atomic Row Locks

Credit deductions execute via Supabase atomic functions with row-level locks, fully protecting concurrent loops from over-billing.

Ready to automate product upscaling with AI?

Generate an API key in seconds and connect your Claude Desktop or Cursor workspace immediately.