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.
{
"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_imageUpscales 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.
imageUrlstring (URL)Requiredscale"2" | "4" | "8"OptionalmaterialTypeenumOptionaloutputPathstring (path)OptionalautoDownloadbooleanOptionalcheck_creditsInspects live credit balance, active subscription tier (Free, Starter, Pro), and storage quota utilization.
check_upscale_statusPolls 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.
imageIdstringRequiredoutputPathstring (path)OptionalautoDownloadbooleanOptionallist_material_typesReturns 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.
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.
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.
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.
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.~/Downloads/ProductImageUpscale), Windows (Downloads\ProductImageUpscale), LinuxHeadless pipelines: set autoDownload: false for URL-only outputProcessing Modes & Category Presets
Pass materialType to switch between standard e-commerce super-resolution and AI face restoration for human models.
generalStandard 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.
modelModel & 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).
fabricFabric & Apparel (Category Preset)
Convenient category alias for clothing, garments, and soft goods catalogs. Runs the standard super-resolution engine with apparel defaults.
leatherLeather Goods (Category Preset)
Convenient category alias for footwear, bags, belts, and leather accessories. Runs the standard super-resolution engine with leather goods defaults.
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.
| Plan | Price | Monthly Credits | Unit Price | Storage Quota | Retention |
|---|---|---|---|---|---|
| Free | $0 | 5 credits / mo | Free | 100 MB | 30-day rolling |
| Starter | $9 / mo | 200 credits / mo | $0.045 / upscale | 500 MB | Permanent |
| Pro | $19 / mo | 2,000 credits / mo | < $0.01 / upscale | 2 GB | Permanent |
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.