# Imgur MCP > Imgur MCP connects your AI agent directly to Imgur's API. Upload images via URL or binary data, build and modify albums, manage community comments, and search the global gallery using natural language commands. It gives you full control over your media assets—from private submissions to public viral content. ## Overview - **Category:** image-video - **Price:** Free - **Tags:** image-hosting, album-management, imgur-api, media-upload, gallery-search ## Description Need to handle a ton of visuals for work? This MCP lets you treat Imgur like just another service endpoint inside your AI agent. You can upload images and update their titles or descriptions on the fly, whether they come from a URL or binary data. It's more than just hosting; it’s full media lifecycle management. Want to organize a big project? Instead of manually adding 50 photos one by one, you tell your agent to create an album and then populate specific collections with images. You can also dig into the Imgur gallery—search for trends or grab viral hits and manage your favorites right from where you're working. Because Vinkius hosts this MCP in its catalog, you connect once and get access to all these image management tools through any compatible AI client. ## Tools ### add_images_to_album Adds specified images to an already existing album. ### create_album Creates a brand new, empty album container in the gallery. ### create_comment Posts a new comment on any item or post within Imgur. ### delete_album Removes an entire album from the gallery using its ID. ### delete_comment Deletes a comment you posted on Imgur. ### delete_image Permanently removes an image from your account or the gallery. ### get_account_gallery_favorites Fetches a list of images and albums you have marked as favorites. ### get_account_settings Retrieves the current settings for your Imgur account (requires an access token). ### get_account_submissions Gets a list of all images and albums you have submitted to the gallery. ### get_account Retrieves basic public user profile data for your Imgur account. ### get_album Retrieves detailed information about one specific album by its ID. ### get_comment Gets all data points for a specific comment, including who made it and when. ### get_gallery Fetches the general content list from the Imgur gallery. ### get_image Retrieves detailed information about a single image, including its views and title. ### search_gallery Searches the entire Imgur gallery for images or albums using keywords. ### submit_to_gallery Submits a new image or album to be visible in the main gallery feed. ### update_image Changes the title or description of an existing image asset. ### upload_image Uploads a new image directly to your account from a file, URL, or base64 string. ### vote_comment Records a vote (up or down) on a comment you view. ## Prompt Examples **Prompt:** ``` Search Imgur gallery for 'vintage photography' and show me the results. ``` **Response:** ``` I've searched the gallery for 'vintage photography'. I found several high-quality matches, including a collection of 1950s street scenes (ID: abc123) and a set of film portraits (ID: def456). ``` **Prompt:** ``` Upload this image URL to Imgur: https://example.com/photo.jpg ``` **Response:** ``` The image has been successfully uploaded! You can view it at https://imgur.com/xyz789. The image hash is xyz789. ``` **Prompt:** ``` Get the details and description for image hash xyz789. ``` **Response:** ``` Fetching details for xyz789... The image is titled 'Sunset over Mountains', has 1,200 views, and is currently set to public visibility. ``` ## Capabilities ### Manage Images Upload new images or modify the titles and descriptions of existing ones. ### Organize Albums Create structured albums, delete old collections, and add multiple specific images to an album at once. ### Search & Browse Gallery Query the global Imgur gallery for content or fetch details about any specific image or album by its hash. ### Manage Account Data Retrieve your personal profile information, view your submissions to the gallery, and check account settings. ### Engage in Community Create new comments on content or vote on existing ones within the Imgur community. ## Use Cases ### The marketing team needs 50 screenshots for a blog post. Instead of manually grabbing images from development builds, the agent runs `upload_image` multiple times and then uses `add_images_to_album` to group them into an 'Alpha Build' album. This keeps everything organized immediately after deployment. ### I need to find inspiration for a new art project. The agent runs `search_gallery` using keywords like 'steampunk architecture.' It returns links and details, allowing the user to grab specific images or view what's trending without leaving their current task. ### I need to update a project image with new context. The original image is uploaded. The user then calls `update_image`, changing the title and description based on new findings, ensuring the asset metadata reflects the latest information for publication. ### I'm building a site that shows my portfolio history. The agent uses `get_account_submissions` to pull all past work. It then calls `get_album` on key albums to fetch metadata, enabling the construction of an automated, comprehensive portfolio view. ## Benefits - Stop switching tabs to manage visuals. You can upload images using `upload_image`—whether it's a file path or a URL—and update their description right from your chat window. - Never lose track of project shots again. Use the album tools (`create_album`, `add_images_to_album`) to build and organize collections, then delete them with `delete_album` when they're done. - Researching visual trends is faster than ever. Instead of browsing manually, use `search_gallery` to pull up specific types of content or topics instantly. - Track your digital footprint easily. You can check all your past work by calling `get_account_submissions` and see exactly what you've posted to the gallery. - Handle community interactions as part of your workflow. After posting, use `create_comment` and `vote_comment` without opening a separate browser tab. ## How It Works The bottom line is that your AI client handles all the back-and-forth with Imgur, so you just give the command and get the result. 1. Subscribe to this MCP and enter your Imgur Client ID (and an Access Token if you need private actions). 2. Your AI client recognizes the connected toolset, making all 19 functions available in natural conversation. 3. You simply tell your agent what you want—like 'create a new album called Q3 assets' or 'search for vintage photography'—and it executes the necessary API calls. ## Frequently Asked Questions **How do I search for images using Imgur MCP?** You run `search_gallery`. Just tell your agent what keywords or themes you are looking for, and it handles querying the entire gallery. **Can I update an image description with Imgur MCP?** Yes. Use the `update_image` tool. You just need to provide the image's ID along with the new title or description text you want it to have. **What if I want to group images into a dedicated album?** You first use `create_album` to make the container. Then, you run `add_images_to_album`, listing all the specific image IDs you want in that new collection. **Does Imgur MCP let me see my past uploads?** Yes, call `get_account_submissions`. This pulls up a record of every image and album you've submitted to the gallery through your account. **How can I manage community interactions, such as creating a comment or voting, using Imgur MCP?** You handle this moderation directly with tools like `create_comment`, `delete_comment`, and `vote_comment`. Your agent executes the necessary API calls to manage the discussion thread. **What process does Imgur MCP use to submit a new image or album to the global gallery?** You utilize the `submit_to_gallery` tool. Your agent takes your prepared media asset and handles the API submission, making it appear live on the Imgur platform. **How can I retrieve my personal account details or check my private settings using the Imgur MCP?** Use `get_account` to pull basic profile information. For deeper control over your credentials, `get_account_settings` retrieves specific user parameters (requires an access token). **How do I remove specific media items, like deleting a comment or an image, with Imgur MCP?** You use dedicated removal tools such as `delete_image`, `delete_comment`, and `delete_album`. Your agent executes the necessary API calls to permanently take down the content. **Can I upload an image just by providing a web URL?** Yes! Use the `upload_image` tool and set the `type` parameter to 'url'. The agent will fetch the image and host it on Imgur for you. **How do I create a private album for my project assets?** Use the `create_album` tool and set the `privacy` parameter to 'hidden' or 'secret'. You can also provide an initial list of image IDs. **Can I see my private account settings through the AI?** Yes, provided you have supplied an Access Token. Use the `get_account_settings` tool to retrieve your current account configuration.