Unsplash MCP. Search, retrieve, and manage high-resolution media assets automatically.
Unsplash MCP connects your AI client directly to Unsplash’s massive library of high-resolution photos and curated collections. Your agent can search by natural language prompts, retrieve photo IDs and direct links, pull entire thematic collections, or even list public portfolios from specific photographers. Stop browsing web pages; let your AI handle the visual asset retrieval automatically.
Give Claude and any AI agent real-world access
You can search Unsplash’s entire library to find high-resolution images that match specific concepts or subjects.
The MCP pulls deep data on any given image, including its ID, resolution properties, and direct hotlinks for use in web projects.
You can request specific themed collections or audit existing photo sets by their unique IDs.
If you need a placeholder image for testing, your agent can retrieve a completely random high-resolution visual instantly.
You can list all the public photos uploaded by a particular photographer or user ID.
The agent retrieves lists of the most recently published images or current editorial topics to see what's popular now.
Ask an AI about this
Waiting for input…
What AI agents can do with Unsplash: 10 Tools for Visual Asset Retrieval
These tools let your AI client systematically search Unsplash—from general keyword searches to specific collection audits—to pull precise, high-resolution media assets.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Unsplash MCPList Collection Photos
Lists every photo contained within an existing Unsplash collection ID.
Get Collection Details
Retrieves all information about a specific, named photo collection.
Get Photo Details
Pulls comprehensive data for any single Unsplash photo.
Get Photographer Photos
Lists every image uploaded by a specific, named user account on Unsplash.
List Latest Photos
Retrieves a list of the most recently published photos from the main feed.
List Editorial Topics
Shows available, curated topics like 'Nature' or 'Architecture' that you can search within.
Get Random Photo
Fetches a random high-resolution photo, optionally narrowed by a specific query.
Search Collections
Searches for entire curated photo collections based on keywords like 'Nature' or...
Search Photos
Performs a broad search across Unsplash, returning IDs and URLs of free...
Search Photographers
Finds specific photographers or artists by their name or username on Unsplash.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Unsplash, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Unsplash. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The daily chore of finding high-quality visual assets
Today, getting the right images means jumping between tabs. You start on a blog post draft, realize you need a hero image, then open Unsplash, type keywords, click through pages of similar photos, and finally download three different high-res files to use in your presentation deck. This process takes time, requires context switching, and often results in inconsistent assets.
With this MCP, that entire manual cycle disappears. You just tell your agent the vibe you're going for—say, 'Industrial warehouse lighting.' Your AI client executes the search against Unsplash’s library and instantly returns a curated set of links with all necessary metadata. The output is ready to use.
Unsplash MCP: Getting assets directly into your workflow
You no longer have to open the Unsplash website, manually type in a collection ID, or copy/paste URLs into a spreadsheet. The MCP handles all those backend steps automatically.
Your agent talks to the Unsplash API directly. It gets you the raw asset links and photographer information right where you are working, keeping your focus on creation, not research.
What Unsplash MCP does for your AI
Need stunning visuals for a project, but hate clicking through dozens of stock sites? This MCP connects your AI client to Unsplash's full photography ecosystem. You get autonomous control over discovering and pulling high-res images right inside your chat interface.
Instead of spending time on the Unsplash homepage manually searching or downloading assets, you give a plain language prompt to your agent—like 'Give me three minimalist shots of coffee shops.' Your AI client then uses this MCP to find those exact photos, pull the direct links, and provide all the metadata needed for proper credit.
It’s like having a dedicated visual research assistant that never gets tired.
When you connect this through Vinkius, your agent can handle complex tasks instantly. You can ask it to search thematic collections by keyword or even pluck out a random high-res image when prototyping a layout. This means less time searching and more time building. It's the difference between browsing an index and getting the finished asset ready for production.
019d7619-ad98-71aa-a804-f7cc3eb07f57 How to set up Unsplash MCP
The bottom line is that you give an instruction in natural language, and your MCP handles all the complicated API calls to get you exactly what you need.
First, manually subscribe to this MCP instance within Vinkius and provide your Personal Unsplash Developer App Access Key.
Next, trigger the photo search or collection audit by giving a specific semantic constraint prompt to your AI client (like Claude or Cursor).
Finally, your agent executes the necessary tools, retrieves the direct asset links and metadata, and presents them directly in your chat window.
Who uses Unsplash MCP
This connector is for anyone whose job involves visual media. If you're a content editor tired of downloading assets from multiple sites, or a developer who needs realistic placeholder images quickly, this saves hours.
You use the MCP to automatically request themed image sets for blog posts, bypassing manual searches and ensuring consistent visual quality.
When scaffolding a new web project, you instruct your agent to pull random visuals or search for specific aesthetics (e.g., 'minimalist coffee shop') to use as realistic placeholders in React components.
You ask the MCP to find entire thematic collections to maintain a consistent brand look and feel across ad campaigns, without leaving your primary workflow tool.
Benefits of connecting Unsplash MCP
Save time by eliminating manual browsing. Instead of opening the Unsplash site and clicking through pages to find images, you simply tell your agent what you need, and it runs a targeted search using search_photos.
Get structured data, not just pictures. The MCP retrieves photo IDs, direct URLs, and metadata. This means your AI client can plug assets directly into code or reports without manual copy-pasting.
Maintain visual consistency across projects. You don't have to settle for random images; you can use search_collections to pull entire thematic bundles of visuals that share a consistent look and feel.
Prototype faster with placeholder imagery. When building a new layout, the MCP lets your agent run get_random_photo, instantly giving you realistic assets so you don't have to stop development to source images.
Track creative sources reliably. Use search_photographers or get_photographer_photos to find and catalogue work from specific artists, ensuring proper attribution right out of the gate.
Unsplash MCP use cases
Building a Portfolio Site
A designer needs 15 images for a client's mood board. Instead of manually searching Unsplash repeatedly, they prompt their agent to use search_collections and then run list_collection_photos on the best result. The agent returns all 15 assets with links in one go.
Testing a Landing Page Layout
A frontend developer needs background images for rapid prototyping. They simply tell their AI client to use get_random_photo multiple times, which instantly provides diverse, high-res assets without the friction of leaving their IDE.
Writing a Travel Blog
A blogger is writing about Italian architecture. They prompt their agent with 'Renaissance buildings' and the MCP uses search_photos to find relevant images, providing direct links for the blog post's embedded visuals.
Researching Brand Identity
A marketing manager needs to see what a competitor might look like. They use search_photographers to locate similar accounts and then run get_photographer_photos to audit the public style of specific artists.
Unsplash MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating it as a simple image search
You ask your agent, 'Find me some cool pictures.' The agent returns 5 links, but you still have to manually check if they are the right resolution or if they belong to a specific theme.
Be precise. Instead of general requests, use search_photos with detailed keywords like 'minimalist coffee shop' and then follow up by using get_collection_details on a promising result for guaranteed consistency.
Relying on the web UI
Spending 30 minutes navigating Unsplash, clicking through themed folders, and copying URLs one by one.
Give your agent the task. Ask it to use search_collections with a broad theme like 'Nature.' The MCP returns the entire structure and assets in an actionable format immediately.
Forgetting attribution
Copying images without knowing who took them, leading to legal or ethical issues.
Always ask your agent to use get_photo_details on the assets you select. This ensures you retrieve not only the link but also the photographer's name and necessary attribution data.
When to use Unsplash MCP
Use this MCP if your core workflow involves sourcing, vetting, or cataloging visual media from Unsplash. If you need to search for specific concepts (e.g., 'cyberpunk city'), pull entire thematic collections (search_collections), or track the work of known artists (get_photographer_photos), this is exactly what you need.
Don't use this if all you need are simple, one-off images and you don't care about metadata. If your goal is merely to find a single random photo for quick testing, get_random_photo handles that fine, but for robust workflow integration involving multiple assets or collections, stick with the full MCP.
If your source of media was Instagram or Pixabay, this MCP wouldn't help—it’s exclusively Unsplash. But if you need to systematically search and retrieve data from Unsplash, it is unmatched.
Frequently asked questions about Unsplash MCP
How do I use the search_photos tool with the Unsplash MCP? +
You ask your agent to run search_photos and provide descriptive keywords. Your agent then uses these tools to return IDs, URLs, and photographer information for free high-resolution images.
Does the Unsplash MCP help me find a specific collection? +
Yes. You can use search_collections by keyword (e.g., 'Nature') or, if you have an ID, use get_collection_details to pull all information on it.
What is the difference between search_photos and get_random_photo? +
Use search_photos when you need results based on specific keywords or themes. Use get_random_photo when you just need an immediate, random high-res placeholder to test a layout.
Can I track the work of one photographer using Unsplash MCP? +
Absolutely. You use the search_photographers tool to find their account, and then run get_photographer_photos to list every public picture they've uploaded.
Is the data from the Unsplash MCP always free to use? +
The MCP retrieves links to high-resolution photos that are available under Unsplash’s licensing terms, and it provides the necessary metadata for proper attribution.