# Viesus MCP > Viesus MCP automatically enhances photos with AI that adjusts exposure, color balance, and sharpness to make any image look professional. It handles upscaling, face restoration, and consistent color correction so you don't have to manually tweak every single asset. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** photo-enhancement, image-retouching, color-correction, ai-upscaling, face-restoration, automated-processing ## Description Need your product shots or portraits to pop? This connector lets your agent handle the heavy lifting of image enhancement. You feed it a batch of images, and it applies powerful AI enhancements like upscaling and automatic color correction. It tracks those jobs for you, letting you monitor status from 'queued' straight through to 'completed'. Plus, if you need to know the technical specs—the resolution or color space—you can pull that metadata instantly. For complex workflows, Vinkius allows you to chain this MCP with other services; maybe first you run a batch of images through an enhancement process, then immediately retrieve the necessary metadata before passing it off for archival. This keeps your entire pipeline running automatically, without you ever having to open a separate photo editor. ## Tools ### check_api_health Verifies whether Viesus's core API services are currently running and available for use. ### enhance_image_ai Applies automated AI processing to an image, performing enhancements like upscaling or color correction. ### get_account_credit_balance Checks how many API credits are remaining for future image processing jobs. ### get_enhanced_image_url Fetches the final, direct download link for a photo that has been successfully processed and enhanced. ### get_image_metadata Gathers technical details about a specific image, such as its resolution and color profile. ### get_enhancement_job_status Provides the current operational status of any image enhancement job you've submitted (e.g., queued or processing). ### get_api_version_info Retrieves the specific version details of the Viesus API currently in use. ### list_supported_file_formats Lists all types of image files that can be uploaded and processed by Viesus. ### list_processing_history Shows a record of the most recent image processing jobs run through the system. ### list_enhancement_presets Pulls a list of all predefined enhancement configurations available for selection. ### list_configured_webhooks Lists any existing automated webhooks set up to notify other systems when processing is complete. ### upload_image_to_viesus Handles the secure upload of a new image file into the Viesus system for processing. ## Prompt Examples **Prompt:** ``` Check my Viesus credit balance. ``` **Response:** ``` I've retrieved your balance. You currently have 450 credits available for image processing. Would you like to check the status of your last enhancement job? ``` **Prompt:** ``` Enhance image 'img_12903' using the 'standard-high' preset. ``` **Response:** ``` AI enhancement initiated! The job has been queued with ID job_8823. I'll monitor the status and let you know as soon as the enhanced version is ready for download. ``` **Prompt:** ``` Show me the technical metadata for the image I just uploaded. ``` **Response:** ``` Fetching metadata... The image (ID: img_10293) has a resolution of 4000x3000px, uses the sRGB color space, and is in JPEG format. Shall we apply an enhancement preset to it? ``` ## Capabilities ### Apply AI enhancements Automatically boosts image quality by adjusting exposure, color balance, and sharpness across multiple photos. ### Check job status Tracks the real-time progress of large batches or complex photo enhancement requests through a simple status check. ### Retrieve image data specs Gathers technical metadata, like color space and resolution, for processed images so you know exactly what you're using. ### Manage processing credits Checks your remaining API balance to ensure the AI agent doesn't run out of resources halfway through a job. ### Apply saved styles Selects from predefined, tested enhancement settings (presets) optimized for specific types of photography or e-commerce needs. ## Use Cases ### Mass-processing product shots An e-commerce team needs 50 new product images standardized. The agent first uses `upload_image_to_viesus` to queue all photos, then calls `list_enhancement_presets` to select the 'ecomm-standard' style, and finally monitors the job status with `get_enhancement_job_status`. This ensures every image is uniform before publishing. ### Archiving historical client photos A photographer needs to archive a shoot. The agent uses `list_processing_history` to review past jobs, then calls `get_image_metadata` on the best shots to confirm they meet print standards. Finally, it retrieves the download link via `get_enhanced_image_url` for archival backup. ### Checking image compatibility A content creator uploads a new asset and needs to know if it works for a specific web banner size. The agent uses `list_supported_file_formats` first, then calls `get_image_metadata` to confirm the resolution matches project specs. ### Building complex automated pipelines An agency wants to process images daily. They set up a workflow using this MCP and chain it with another service that handles billing, guaranteeing that processing jobs automatically trigger resource checks via `get_account_credit_balance` first. ## Benefits - Stop manually adjusting every image. The `enhance_image_ai` tool runs powerful upscaling and color correction automatically, giving you high-quality results instantly. - Never lose track of a batch job again. Use `get_enhancement_job_status` to monitor requests in real time, whether they're queued or actively processing. - Know your data down to the pixels. The `get_image_metadata` tool pulls technical specs like resolution and color space without needing external software. - Maintain consistency across campaigns by selecting from saved settings using `list_enhancement_presets`, ensuring every photo looks part of the same collection. - Keep things moving without interruption. You can check your remaining credits with `get_account_credit_balance` before starting a large batch upload, preventing job failure. - Get the final asset directly. Once done, you use `get_enhanced_image_url` to retrieve the guaranteed download link for your finished work. ## How It Works The bottom line is: your AI client handles all the API calls and data parsing; you just talk to it naturally about photos. 1. First, subscribe to this MCP and input your Viesus Cloud API Access Token. 2. Next, tell your agent what you want—like enhancing a specific image or listing available enhancement presets. 3. Finally, the agent processes the request on Viesus and returns status updates, download links, or technical metadata. ## Frequently Asked Questions **How do I check my credit balance using the `get_account_credit_balance` tool?** You simply ask your agent to 'Check my Viesus credits.' The agent will run the call and tell you exactly how many API credits are left, so you know if you can start the enhancement job. **Can I use `list_enhancement_presets` for different clients?** Yes. You list all available presets first to see what's optimized for your needs. Then, when running `enhance_image_ai`, you tell the agent to apply a specific preset ID. **What is the difference between `get_image_metadata` and `list_processing_history`?** `get_image_metadata` tells you the technical specs (like resolution) of one image. `list_processing_history` shows a chronological list of all jobs run through the system. **How do I get the final picture after running `enhance_image_ai`?** After calling `enhance_image_ai`, you wait for the job to finish. Once done, use `get_enhanced_image_url` to pull the secure link and download the finished file. **What should I do if the `check_api_health` tool reports an error?** The immediate problem is usually your API token or network connection. First, verify that your Viesus Cloud access token hasn't expired in your agent’s settings. If the status check still fails, double-check your internet connectivity and try running the command again later. **What file types can I use when I call `list_supported_file_formats`?** The tool provides a definitive list of all accepted formats. Generally, you'll find common web images like JPEG and PNG listed. Always check the output to confirm your specific source file type is supported before attempting an upload. **How do I automate notifications for my jobs using `list_configured_webhooks`?** Listing configured webhooks shows you where Viesus sends data. To automate, you set a webhook URL that Viesus hits when an event happens (like image completion). This lets your agent react automatically without needing to constantly check for updates. **If my job gets stuck, how do I diagnose it using `get_enhancement_job_status`?** Just provide the unique job ID to this tool. It immediately returns the current state: queued, processing, failed, or completed. This lets you quickly pinpoint delays or determine if a manual retry is necessary. **Can I check how many credits I have left in Viesus?** Yes! Use the `get_account_credit_balance` tool. Your agent will retrieve the current number of processing credits available in your account. **How do I download the enhanced version of my image?** Once the job status is 'completed', use the `get_enhanced_image_url` tool with your Job ID to get the direct download link for the final photo. **What are the supported file formats for enhancement?** You can run the `list_supported_file_formats` query to see a complete and up-to-date list of all input and output formats supported by the Viesus API.