# Unsplash MCP for AI Agents AI Agent Connect > Unsplash. This Connector lets your AI agent browse millions of high-resolution images, manage your curated collections, and pull engagement stats directly from the Unsplash library. It turns your chat interface into a powerful media search engine, making it easy to find the right visuals for projects without leaving your workspace. Use it to find inspiration, organize assets, and track your content's performance in one place. ## Overview - **Category:** design-creative - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/ai-agent-connect - **Tags:** stock-photography, image-search, visual-assets, creative-workflow, media-library, high-resolution ## Description Imagine you're in the middle of a deep creative session and you need a specific kind of image. Instead of opening a new tab, searching a stock site, and sifting through pages of results, you just tell your agent what you're looking for. This Connector brings the entire Unsplash library into your current workflow. It handles the heavy lifting of filtering by orientation, topic, or collection so you can keep your momentum. You can also organize your favorites into custom folders, update existing collections, or check how your own content is performing. It's about making visual discovery a part of your conversation rather than a distraction. By connecting this to your setup via the Vinkius catalog, you're giving your agent the eyes to see what you're thinking of. You don't have to copy and paste URLs anymore. You just get the right imagery, the right metadata, and the right organization, all while staying focused on the task at hand. ## Tools ### get_photo Get a single photo by its unique ID. This is useful for retrieving specific image details quickly. ### search_users Search for users on Unsplash using a keyword. Use this to find specific photographers or contributors. ### add_photo_to_collection Add a photo to a specific collection using your account. This helps you build your personal visual library. ### list_user_photos List all photos uploaded by a specific user. It is a great way to see a photographer's full portfolio. ### remove_photo_from_collection Remove a photo from a collection using your account. Use this to keep your curated folders organized. ### search_collections Search for public collections using a keyword. This helps you find curated groups of images from others. ### search_photos Search the Unsplash library for photos matching a keyword. This is the primary way to find new imagery. ### track_photo_download Track a photo download for proper attribution. Use this to stay compliant with Unsplash API guidelines. ### create_collection Create a new photo collection using your account. This lets you group images by project or theme. ### delete_collection Delete a collection from your account. Use this to clean up your personal visual library. ### get_collection_photos Get all photos inside a specific collection. This helps you see everything in a group at once. ### get_collection Get the details of a specific collection by its ID. Use this to see the metadata of a curated group. ### get_me Get your own authenticated profile information. Use this to check your current account status. ### get_photo_statistics Get statistics for a specific photo. This shows you how many views and downloads an image has. ### get_random_photo Get one or more random photos from the library. This is perfect for quick inspiration. ### get_related_collections List related collections for a given collection ID. Use this to find similar visual themes. ### get_topic_photos Get photos for a specific topic. This helps you find images categorized by the Unsplash editorial team. ### get_topic Get a single topic by ID or slug. Use this to see the details of a specific category. ### get_user_statistics Get user download and view statistics. Use this to see the total reach of a specific user's content. ### get_user Get a user public profile. Use this to view the public details of any photographer. ### like_photo Like a photo on behalf of your account. This helps you curate your personal feed. ### list_collections List all public collections. Use this to explore what other users are curating. ### list_photos List photos from the editorial feed. This shows you what is currently trending on the platform. ### list_topics List all topics. Use this to see the full range of categories available on Unsplash. ### list_user_collections List collections created by a user. Use this to see all your personal curated folders. ### unlike_photo Remove a like from a photo on behalf of your account. Use this to manage your liked content. ### update_collection Update an existing collection using your account. Use this to modify your curated folders. ### update_me Update your own profile information. Use this to manage your account details. ## Prompt Examples **Prompt:** ``` Find 3 photos of 'cyberpunk city' in vertical orientation. ``` **Response:** ``` I've found 3 high-resolution cyberpunk city photos for you. | Photo | Description | Orientation | | :--- | :--- | :--- | | **Photo 1** | Neon-lit skyscrapers with rain reflections | Vertical | | **Photo 2** | Cybernetic street market with glowing signs | Vertical | | **Photo 3** | Futuristic alleyway with holographic ads | Vertical | Would you like the download links for any of these? ``` **Prompt:** ``` What are the stats for the user 'nature_pro'? ``` **Response:** ``` The user **nature_pro** has significant engagement on the platform: * **Total Views:** 2.4M * **Total Downloads:** 850k * **Total Uploads:** 312 photos Would you like to see their most popular collections or find some of their top photos? ``` **Prompt:** ``` Get a random photo from the 'Architecture' topic. ``` **Response:** ``` Here is a stunning random photo from the **Architecture** topic: **[Image: A modern glass structure reflecting a sunset]** * **Photographer:** User_Design_99 * **Topic:** Architecture Would you like to see more from this photographer or find similar collections? ``` ## Capabilities ### Search for specific imagery Find photos by keyword, topic, or orientation using your agent. ### Organize custom collections Create and manage folders of your favorite images. ### Retrieve user profiles Get public data and upload history for any Unsplash user. ### Track engagement stats See view and download counts for photos and users. ### Fetch random inspiration Get random photos from specific topics to break creative blocks. ### Curate your feed Like or unlike photos to shape what you see on the platform. ### Browse editorial feeds See what the Unsplash team is featuring right now. ## Use Cases ### Finding visual assets for a social campaign A social media manager needs 5 photos of urban gardening. They ask their agent to find them and get the links instantly. ### Exploring trending design styles A designer wants to see what's trending in minimalist architecture. They use the agent to browse the editorial feed. ### Analyzing photographer performance A developer wants to see the stats for a specific photographer. They ask the agent to pull the view and download counts. ### Organizing project-specific imagery A content creator wants to organize all travel photos into a folder. They ask the agent to create a collection and add photos to it. ## Benefits - Stop switching tabs by using search_photos to find imagery while you stay in your workspace. - Keep your assets organized by using create_collection and add_photo_to_collection to build your library. - Get instant inspiration by using get_random_photo to break through creative blocks during planning. - Monitor your reach with get_user_statistics and get_photo_statistics to see how your content performs. - Stay compliant with attribution rules by using track_photo_download every time you pull an image. - Curate your personal feed by using like_photo and unlike_photo to tell the system what you enjoy. ## How It Works The bottom line is you get direct access to a massive image library without ever leaving your AI chat. 1. Subscribe to the Unsplash MCP on Vinkius and get your access keys. 2. Enter your Unsplash Access Key and Bearer Token into your AI client. 3. Ask your agent to search for photos, manage your collections, or pull stats. ## Frequently Asked Questions **Can the Unsplash MCP find specific types of photos for my project?** Yes, it can search the entire Unsplash library using keywords, topics, and orientations. Your agent can find exactly what you need without you having to browse manually. **How do I manage my own collections with the Unsplash MCP?** You can create, update, and list your own personal collections. This lets you organize your favorite images into project-specific folders using just your voice or text. **Can I see how many times a photo has been downloaded?** Yes, the Connector can pull engagement statistics for specific photos. This is helpful for seeing which types of imagery are performing best. **Does the Unsplash MCP help with content inspiration?** It does. Your agent can pull random photos from specific topics or browse the editorial feed to show you what is currently trending in the design world. **Can I use the Unsplash MCP to organize my favorite images?** Absolutely. You can add photos to custom collections as you find them, making it easy to keep your visual assets organized by theme or project. **Is there a way to track photo downloads for attribution?** Yes, the Connector includes a tool to track photo downloads. This ensures you stay compliant with Unsplash's requirements for proper attribution. **Can I fetch a random photo based on a specific search term or topic?** Yes! Use the `get_random_photo` tool. You can provide a `query` (like 'nature') or `topics` IDs to filter the random selection to exactly what you need. **Is it possible to create and manage my own photo collections via the AI?** Absolutely. With a valid Bearer Token, you can use `create_collection`, `add_photo_to_collection`, and `remove_photo_from_collection` to curate your Unsplash assets directly through conversation. **How can I check the performance or popularity of a specific photo?** You can use the `get_photo_statistics` tool by providing the photo ID. It will return detailed metrics including total views and downloads.