Vinkius

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.

Unsplash MCP is compatible with Claude Claude
Unsplash MCP is compatible with ChatGPT ChatGPT
Unsplash MCP is compatible with Cursor Cursor
Unsplash MCP is compatible with Gemini Gemini
Unsplash MCP is compatible with Windsurf Windsurf
Unsplash MCP is compatible with VS Code VS Code
Unsplash MCP is compatible with JetBrains JetBrains
Unsplash MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

Find photos using keywords

You can search Unsplash’s entire library to find high-resolution images that match specific concepts or subjects.

Retrieve photo details and links

The MCP pulls deep data on any given image, including its ID, resolution properties, and direct hotlinks for use in web projects.

Browse curated groups of photos

You can request specific themed collections or audit existing photo sets by their unique IDs.

Get random inspiration shots

If you need a placeholder image for testing, your agent can retrieve a completely random high-resolution visual instantly.

Track specific artists' work

You can list all the public photos uploaded by a particular photographer or user ID.

List trending and new content

The agent retrieves lists of the most recently published images or current editorial topics to see what's popular now.

Waiting for input…

AI Agent
Unsplash

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 MCP

List 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.

Unsplash MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Unsplash integration is available immediately — no restart needed.

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
Start building

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
Unsplash MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius Unsplash - Find High-Res Images with AI
Server ID 019d7619-ad98-71aa-a804-f7cc3eb07f57
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.