# APImage MCP MCP > APImage MCP connects a world-class press image archive directly into your AI workflow. It lets you generate complex visuals from simple text prompts, remove backgrounds, upscale assets, or refine images by filling in missing details—all through natural conversation with your agent. ## Overview - **Category:** design-creative - **Price:** Free - **Tags:** generative-ai, background-removal, image-editing, text-to-image, media-assets, upscaling ## Description You can use this connector to manage the entire lifecycle of visual asset creation without leaving your chat client. Need a mockup for a new product? Give an initial prompt and generate it immediately. If that image isn't quite right, you don't start over; you refine it by telling the agent exactly what to change, or you can tell it to expand a basic concept into a highly detailed description first. This MCP handles everything from pure text-to-image generation using multiple models to cleaning up existing assets, like removing backgrounds for e-commerce listings. It's all exposed through Vinkius, giving your agent access to industry-standard creative tools right where you need them. ## Tools ### check_apimage_status Verifies if your API connection is active and working correctly. ### enhance_prompt Expands a simple text description into a detailed prompt for better image generation results. ### generate_image Creates an image based on a provided text prompt, with the option to specify different AI models. ### get_generation Retrieves specific details about a previously generated image job. ### image_to_image Transforms an existing image by applying new stylistic or structural changes based on a text prompt. ### inpaint_image Fills in gaps within a masked region of an image using AI-generated content. ### list_generations Shows a history of all images you've generated, along with the used prompts and parameters. ### list_models Lists all available AI models so you can pick the best one for your task. ### remove_background Separates an image from its background, resulting in a transparent PNG file. ### upscale_image Increases the resolution of an existing image by 2x or 4x while maintaining quality. ## Prompt Examples **Prompt:** ``` Generate an image of a futuristic city at sunset using the Flux model. ``` **Response:** ``` Image generated! Here's your futuristic cityscape at sunset using Flux 1 Dev (Generation ID: gen_8291). The image features a skyline with glass towers reflecting orange and purple hues. Would you like to upscale it or generate a variation? ``` **Prompt:** ``` Remove the background from this product photo: https://example.com/product.jpg ``` **Response:** ``` Background removed! The product is now on a transparent background (PNG format). Download URL: https://apimage.org/results/bg_removed_4821.png. Would you like to place it on a new background? ``` **Prompt:** ``` Enhance this prompt: 'a cat sitting on a windowsill'. ``` **Response:** ``` Enhanced prompt: 'A fluffy tabby cat sitting peacefully on a sun-drenched wooden windowsill, warm golden afternoon light streaming through lace curtains, potted herbs in the background, soft bokeh, photorealistic, 4K detail'. Would you like to generate an image with this enhanced prompt? ``` ## Capabilities ### Concept Generation Creates entirely new visuals from text prompts or existing images using specialized models. ### Image Refinement and Editing Modifies specific parts of an image, like filling in masked areas or transforming the style while keeping core elements intact. ### Asset Cleanup Processes existing photos by removing backgrounds to get transparent PNGs or increasing resolution (upscaling). ### Prompt Engineering Takes vague text inputs and automatically expands them into detailed, high-quality descriptions that yield better results. ## Use Cases ### The E-commerce Product Shot A manager has 50 product photos, but they all have cluttered backgrounds. Instead of hiring a retoucher for hours, the agent runs `remove_background` on every file and then uses `upscale_image` to make them web-ready at 4K resolution. ### The Marketing Campaign Visual A designer needs concept art for a new ad. They start with 'cyberpunk street scene.' The agent first runs `enhance_prompt`, which expands that into technical detail, and then uses `generate_image` to create the final asset. ### The Historical Photo Restoration A researcher has an old photo with a corner torn out. They use `inpaint_image` to mask the missing area and prompt the AI to fill it in, restoring the image without guessing too much. ### The Style Transfer Mockup A developer has an existing UI screenshot but wants it to look like a watercolor painting. They use `image_to_image`, feeding the original file and prompting for 'watercolor style' to get the desired effect. ## Benefits - You can turn simple ideas into complex assets. Use `enhance_prompt` on a basic concept like 'blue flowers' and get a detailed prompt ready for generation. - Never lose work or forget parameters. The `list_generations` tool keeps a clean record of every asset you make, along with the prompts you used. - Need to fix an image? Instead of redrawing it, use `inpaint_image` to fill in missing parts of a photo with AI-generated content. - Stop resizing and losing quality. The `upscale_image` tool boosts resolution by 2x or 4x without making the asset look soft or blurry. - Refining assets is simple. If you have an image but need it to feel different, run `image_to_image` with a new prompt to transform its style while keeping the core subject. - Start fresh with multiple models. You can use `list_models` before running `generate_image` to pick the specific engine best suited for your visual goal. ## How It Works The bottom line is, you get to treat image creation not as separate steps, but as one continuous conversation with your AI client. 1. Connect your API Key to this MCP via Vinkius. You'll need the key from your APImage account settings. 2. Instruct your AI client on the task (e.g., 'Generate a picture of a vintage car'). 3. The agent uses the appropriate tool, delivers the asset details, and you can then chain further actions like upscaling or removing backgrounds. ## Frequently Asked Questions **How do I generate an image using the APImage MCP?** You tell your agent what you want to see, and it uses `generate_image`. You can also use `list_models` first if you need help deciding which AI engine works best for that prompt. **What's the difference between generate_image and image_to_image?** `generate_image` creates something new from scratch using just a text prompt. `image_to_image`, though, takes an existing file and changes its style or structure based on a prompt you give it. **Can I clean up my photos with the APImage MCP?** Yes. For background removal, use `remove_background` to get a transparent PNG. If the image is too low quality, run `upscale_image` first. **What if I have a vague idea for an image? Do I need enhance_prompt?** It helps immensely. Running `enhance_prompt` takes a simple phrase and turns it into a technical, detailed prompt that vastly improves the quality of your final generated images. **How do I check if my APImage MCP connection is active using the `check_apimage_status` tool?** You run the `check_apimage_status` command to instantly verify your API connectivity. This confirms that the link between your AI client and the image archive is solid before you start generating complex images. **If I want to see my history of generated art, should I use the `list_generations` tool?** Yes, call `list_generations` to pull up a complete record. This shows every prompt you used, all parameters set, and provides direct download URLs for everything you've created. **What is the correct way to increase the size or quality of an existing photo using the `upscale_image` tool?** The `upscale_image` tool boosts resolution by 2x or 4x. You provide it with an image and get a high-quality version that preserves all the original fine details. **How can I find out which specific AI models are available for my projects using `list_models`?** Use `list_models` to view every model variant currently available. This lets you pick the perfect generator—like Flux or Stable Diffusion—for the exact style your project needs. **Which AI image models are available?** Use the `list_models` tool to see all supported models. Current options include Flux 1 Dev, Flux 1 Schnell, Stable Diffusion XL, and DALL-E 3. Each model has different strengths for various visual styles. **Can my AI upscale an image and remove its background in one session?** Yes. Use `upscale_image` first to increase resolution, then `remove_background` on the result. Both tools accept image URLs, so you can chain operations seamlessly. **How does inpainting work?** The `inpaint_image` tool requires three inputs: the source image URL, a mask image URL (white areas = regions to fill), and a text prompt describing what to generate in those areas. The AI fills the masked regions while preserving the rest of the image.