# Unsplash MCP for AI Agents AI Agent Connect

> Unsplash MCP. Manage your visual discovery by searching photos, users, and collections through your AI client. It turns photo hunting into a natural conversation, letting you find high-quality imagery without leaving your workspace.

## Overview
- **Category:** design-creative
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CTcTrYj9TCY2Oy8tTe5jxAbXdCRNmFi1ZPbTuBXy/ai-agent-connect
- **Tags:** stock-photography, visual-assets, image-search, collections, creative-workflow

## Description

You're tired of jumping between tabs to find the right vibe for a project. This Connector lets your AI agent act as a professional visual curator, pulling high-quality imagery directly into your workflow. Instead of scrolling through endless pages of results, you just tell your agent what you're looking for. It can audit photographer portfolios, find specific themes in curated collections, or grab random photos for quick inspiration for a mood board. Because it's hosted on Vinkius, you get a reliable way to connect your favorite AI tools to the world's biggest photo library. It takes the friction out of sourcing assets, making sure your projects always have the right visual weight without the manual hunt. You can check out how well specific images are performing or see what's trending in real-time, all through a natural conversation with your agent. It turns a tedious search process into a simple request for a visual asset. You don't have to worry about navigating complex filters or remembering specific photographer names. Your agent handles the heavy lifting of discovery, allowing you to stay focused on the creative work that actually matters. Whether you're building a brand identity or just need a placeholder for a layout, this connection makes your visual discovery as fast as your thoughts.

## Tools

### search_collections
Search for curated collections. This is the best way to find themed imagery for a specific project.

### get_collection
Get the details for a specific collection. Use this to see what's inside a curated set of images.

### get_photo_stats
Get statistics for a specific photo. This lets you see how well an image is performing or reaching an audience.

### get_photo
Get details for a specific photo. This is useful for pulling metadata like descriptions or photographer info.

### get_random_photo
Grab a high-quality random photo. Use this when you just need a quick visual spark for a layout.

### get_user_photos
List all photos uploaded by a specific user. This helps you see a creator's full body of work at a glance.

### get_user
Get the details for a specific Unsplash user. Use this to check out creator profiles and their specific stats.

### list_topics
List curated topics on Unsplash. Use this to stay on top of trending visual themes and styles.

### search_photos
Search for high-quality photos using keywords. This is your primary tool for finding specific visual content.

### search_users
Search for users on Unsplash. Use this to find specific photographers or creators by name.

## Prompt Examples

**Prompt:** 
```
Find some high-quality photos of Alpine mountains for a travel blog.
```

**Response:** 
```
### Alpine Mountain Imagery
I've found several high-quality options for your travel blog. Here are the top results:

| Photographer | Description | Link |
| :--- | :--- | :--- |
| Elena Rossi | 'Snow-capped peaks at sunrise' | [View Image](#)
| Marcus Chen | 'Alpine meadows in bloom' | [View Image](#)
| Sarah J. | 'Aerial view of jagged peaks' | [View Image](#)

**Quick Tip:** These are all high-resolution and suitable for blog headers.
```

**Prompt:** 
```
Give me a random photo for a cyberpunk city mood board.
```

**Response:** 
```
### Random Inspiration
I've pulled a striking image for your mood board:

**Visual:** A neon-drenched alleyway with heavy rain reflections.
**Photographer:** Jaxson Reed
**Link:** [View Full Resolution](#)

This fits the 'Cyberpunk' aesthetic perfectly with its high contrast and urban decay themes.
```

**Prompt:** 
```
Who is the photographer for the 'Nature' collection and what else have they posted?
```

**Response:** 
```
### Collection Insight
The 'Nature' collection features a variety of creators, but a primary contributor is **Liam Vance**.

**Liam Vance's Portfolio Highlights:**
*   *Forest Mist* (High-res landscape)
*   *Deep Woods* (Macro nature shot)
*   *River Flow* (Long exposure water)

Would you like me to list more of his specific uploads or find a different collection?
```

## Capabilities

### Search for high-res photos by keyword or orientation
Your agent finds specific images based on your descriptive prompts and desired aspect ratios.

### Audit specific photographer profiles and their full portfolios
Get a complete view of a creator's work to ensure their style matches your project needs.

### Find and list curated collections for themed imagery
Retrieve grouped sets of photos that share a specific aesthetic or narrative theme.

### Grab random photos for quick inspiration or mood boarding
Pull high-quality images instantly when you just need a spark of visual inspiration.

### Check photo performance and reach via statistics
See how specific images are performing to understand their reach and visual impact.

### Identify trending visual themes through curated topics
Discover what's currently hot in the visual world through curated platform topics.

## Use Cases

### Finding 'Cyberpunk' vibes
A designer asks for 'neon-lit urban landscapes' and gets a list of high-quality matches with direct links.

### Portfolio Auditing
A creative lead wants to see everything by a specific creator and uses get_user_photos to review their style.

### Trend Research
An art director asks for trending topics and uses list_topics to identify new visual themes for a spring campaign.

### Rapid Inspiration
A content creator needs a quick visual spark and asks for a random photo to break through a creative block.

## Benefits

- Stop manual searching: Use search_photos to find exactly what you need without leaving your editor.
- Faster mood boarding: Use get_random_photo to populate layouts with high-quality inspiration instantly.
- Better creator discovery: Use search_users and get_user_photos to find and audit specific photographer portfolios.
- Theme-based sourcing: Use search_collections to find curated sets of images that fit a specific project vibe.
- Performance tracking: Use get_photo_stats to see how specific images are reaching and performing in the wild.
- Trend awareness: Use list_topics to stay ahead of visual trends across the platform without manual browsing.

## How It Works

The bottom line is you get a dedicated visual researcher that works inside your existing AI chat or editor.

1. Subscribe to the Unsplash MCP on Vinkius.
2. Paste your Unsplash Access Key into your client settings.
3. Ask your agent to find, list, or audit photos and collections.

## Frequently Asked Questions

**Can the Unsplash MCP find specific types of photos?**
Yes, it uses keywords to find high-quality images that match your description exactly, helping you skip the manual scrolling.

**How do I find themed images for a project?**
You can ask your agent to search curated collections to find groups of photos that share a specific aesthetic or narrative theme.

**Can I see what other photos a specific photographer has?**
Yes, the Connector can pull a list of all uploads from a specific user so you can audit their portfolio before choosing their work.

**Does this help with trend research?**
It can list curated topics on Unsplash to help you see what's currently trending in the visual world, which is great for staying ahead of the curve.

**Can I get stats on how photos are performing?**
Yes, it can retrieve specific statistics for photos to help you understand their reach and visual impact on the platform.

**Is this for professional use?**
It's widely used by designers and marketers to find high-quality, freely-usable imagery for commercial projects and brand identity.

**How do I find my Unsplash Access Key?**
Log in to the [**Unsplash Developer portal**](https://unsplash.com/developers), create a new Application, and you will find your Access Key (Client ID) under the 'Keys' section. Copy and paste it below.

**Can the agent filter photos by orientation?**
Yes. Use the `search_photos` tool providing the `orientation` parameter (landscape, portrait, or squarish). Your agent will return matching images instantly.

**Is it possible to retrieve photo statistics via the agent?**
Yes. The `get_photo_stats` tool allows your agent to fetch real-time download and view counts for any specific photo by providing its Photo ID, helping you audit image reach.