# autoRetouch MCP MCP > autoRetouch MCP connects advanced image retouching directly into your AI workflow. It handles complex e-commerce tasks like removing backgrounds, correcting product colors, and adding shadows to large batches of photos automatically. Get high-fidelity results without ever leaving your chat interface. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** photo-editing, background-removal, image-processing, automation, e-commerce-tools, retouching ## Description Stop manually dragging raw product shots through web tools for every catalog update. This MCP lets your agent manage entire image pipelines using natural conversation. You tell it what needs fixing—say, 'Remove the background and increase the saturation on these 50 photos'—and it handles the rest. It runs complex workflows that process images in bulk, monitoring everything from start to finish. If you need to track costs or check how many files are left in a batch, your agent gets that data instantly. Need access to this kind of automation? Check out the full catalog on Vinkius; autoRetouch handles all the heavy lifting so your AI client just talks to it. ## Tools ### create_execution Starts a single image processing task and returns its unique ID. ### get_batch Retrieves specific details for an entire group of submitted images. ### get_execution Gets the current status and details of one specific job run. ### get_image Retrieves detailed metadata for a single uploaded image asset. ### get_organization Fetches core details about your entire organizational account profile. ### get_wallet_balance Checks the remaining credit balance on your account wallet. ### get_workflow Retrieves all settings and details for a specific image processing workflow setup. ### list_batches Lists records of all previously created batches, allowing you to select one for review. ### list_executions Gets a list of recently run image processing jobs, perfect for quick status checks. ### list_images Provides a directory listing of all images uploaded to your account. ### list_workflows Retrieves names and IDs for every available image processing workflow you've created. ## Prompt Examples **Prompt:** ``` List all active image processing workflows in my organization. ``` **Response:** ``` I've retrieved your workflows. You currently have 3 active AI pipelines: 'Ghost Mannequin' (ID: wf_123), 'Shadow Gen', and 'Bulk Background Remove'. Which one should we use? ``` **Prompt:** ``` Run the 'Ghost Mannequin' workflow (ID: 'wf_123') on image ID 'img_456'. ``` **Response:** ``` Execution triggered! I've started processing image img_456 using the specified workflow. The execution ID is 'exec_789'. I'll monitor the status and notify you when the high-fidelity result is ready. ``` **Prompt:** ``` Check status and get the result URL for execution 'exec_789'. ``` **Response:** ``` Fetching status... Execution exec_789 is currently 'Success'. You can access your high-fidelity processed image here: [result_url]. Need any help with more batch tasks? ``` ## Capabilities ### Initiate image processing Starts a new job to retouch raw images using specified workflows. ### Track batch jobs Retrieves details and status for entire groups of submitted images, helping you monitor large-scale tasks. ### Check single job status Gets the current state of a specific image processing run, confirming if it succeeded or failed. ### Retrieve processed images Fetches the final result URLs and metadata for successfully completed retouching jobs. ### Manage organizational settings Retrieves your account's profile details and current financial balance. ## Use Cases ### Need to process 500 new SKUs for sale. The catalog manager tells the agent: 'Run the 'Ghost Mannequin' workflow on all images in the last uploaded batch.' The agent then tracks the progress using get_execution until all 500 items are marked as finished, and finally retrieves all result URLs. ### Color correction across multiple brands. A marketing agency needs to standardize color profiles. They ask the agent to list available workflows, select 'Color Balance,' run it on 20 images using create_execution, and then check get_image for metadata confirmation before submitting them. ### Need an audit trail of all image usage. The operations team uses list_batches to review every historical group submission. Then they use get_organization to validate the account's overall operational status and check the wallet balance. ## Benefits - Centralized Image Management: Use list_workflows and list_batches to view every available pipeline and job group from one place, eliminating the need to jump between separate web dashboards. - Full Visibility into Job Status: Don't guess if a job worked. You can use get_execution or list_executions to check the real-time status of any run, whether it succeeded or failed. - Financial Control: The get_wallet_balance tool gives your agent immediate access to your account credit. Always know how much budget you have before starting a massive batch job. - Workflow Orchestration: Use list_workflows and then get_workflow to define complex image pipelines (like 'background removal + shadow generation') programmatically, all through simple chat commands. - Data Retrieval: Once the processing is done, your agent fetches the result URLs directly using get_image details. You never have to download a file just to copy a link. ## How It Works The bottom line is that you talk to your AI client, and the MCP handles all the state management and data retrieval in the background. 1. First, connect your AI client to the autoRetouch MCP. You'll need your API token and Organization ID from the dashboard. 2. Next, instruct your agent using natural language commands. For example, ask it to start a job or list available workflows. 3. Finally, the agent executes the call, providing immediate status updates on running tasks or delivering the final result URLs for processed images. ## Frequently Asked Questions **How do I find my autoRetouch API credentials?** Log in to your account, navigate to the API section to generate an Access Token (Bearer), and find your Organization ID in the organization settings. **Can I process multiple images at once?** Yes! You can trigger individual executions programmatically and group them into a single batch for high-fidelity tracking. **What happens if a process fails?** The `get_execution_status` tool will return high-fidelity error metadata to help you diagnose and re-run the task programmatically. **How can I check my account status using the get_organization tool?** You use get_organization to retrieve your current organization details immediately. This confirms which user profile is running the processes and helps verify if any organizational limits are being hit. **What do I need to know about listing workflows using list_workflows?** list_workflows gives you a comprehensive catalog of every image processing pipeline available. You can review these details before selecting one to run, ensuring the right settings are applied to your project. **If I need to see all my recent jobs, should I use list_executions or get_execution?** Use list_executions when you want a quick overview of multiple finished or running tasks. If you know the specific ID and just need detailed status for one job, then run get_execution. **How do I check if I have enough credit to process new images using get_wallet_balance?** Run get_wallet_balance anytime before a large batch job. This confirms your available credits and gives you instant financial visibility for operational reporting. **I uploaded files; how do I list them all with the list_images tool?** list_images pulls up a clean list of every image file currently stored in your account. This lets you easily check which assets are ready to be retouched or processed.