Use Unsplash with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Automate high-resolution photo searches via Unsplash. find images, browse collections, retrieve user portfolios, and get random inspiration directly from your
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 10 capabilities
The complete Unsplash capability set.
These are the exact actions your AI can choose when you ask it to work with Unsplash.
01-04
4 capabilities in this set.
Part of 10 available through Unsplash.
- 01
Get photo details
Retrieves details for a specific Unsplash photo
- 02
List editorial topics
Lists curated editorial topics (Nature, Architecture, etc.)
- 03
List latest photos
Lists the most recently uploaded photos on Unsplash
- 04
Search collections
G. "Nature", "Industrial"). Search for curated photo collections by keyword
05-07
3 capabilities in this set.
Part of 10 available through Unsplash.
- 05
Search photos
Returns photo IDs, URLs, and photographer information. Note: Proper attribution is required. Search Unsplash for free high-resolution photos
- 06
Get random photo
Optionally provide a query to narrow the random selection. Retrieves a random high-resolution photo
- 07
Search photographers
Search for Unsplash photographers by name or username
08-10
3 capabilities in this set.
Part of 10 available through Unsplash.
- 08
Get photographer photos
Lists photos uploaded by a specific Unsplash user
- 09
Get collection details
Retrieves details for a specific photo collection
- 10
List collection photos
Requires a collection ID. Lists all photos contained within a specific collection
Observed, not estimated
895ms average. Fast in production.
Unsplash is checked daily against the live service.
- Fastest day
- 761ms
- Slowest day
- 1172ms
- 14-day trend
- Improving-17%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Unsplash, so you can see the experience inside your AI.
It does not authenticate your account with Unsplash. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
Unsplash Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_tVCspzUWSyNRd0SNraQ4VaQPmfAvyOIBUjZ8zjsu/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Unsplash capabilities are ready to use.
{
"mcpServers": {
"unsplash-mcp": {
"url": "https://edge.vinkius.com/vk_preview_tVCspzUWSyNRd0SNraQ4VaQPmfAvyOIBUjZ8zjsu/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions Unsplash owners ask.
- 01
Can it automatically fetch 5 relevant images based on an abstract concept and give me direct URLs?
Yes. Command the LLM using 'search_photos' with a query like 'Serenity' and 'per_page: 5'. It leverages the native search algorithm to bring back structured output containing precise image hotlinks alongside the photographers' names for attribution.
- 02
If I am building a mock UI, can it provide a purely random high-res placeholder image?
A perfect use case! Instruct the AI to call 'get_random_photo'. It skips conventional heavy searches pulling one brilliant, random massive resolution photo. You can even filter the chaos slightly (e.g., random 'architecture').
- 03
How do I ensure I get photos only from a specific trusted photographer I like?
If you know their handle, fire off the 'get_photographer_photos' payload. The bot will bypass generic listings entirely, retrieving paginated bundles of art exclusively captured and uploaded by that precise account profile natively.
Explore
More in Design Creative
TripAdvisor AI Connector
Search hotels, restaurants, and attractions via TripAdvisor Content API — get reviews, ratings, and POI detail
ViewMet Museum AI Connector
Explore the Metropolitan Museum of Art's collection—search for artworks, list departments, and retrieve detail
ViewMediaSilo (Legacy) AI Connector
Share and review video content with creative teams using secure media workspaces, annotations, and approval wo
ViewKnowledgeOwl AI Connector
Manage your knowledge base — list articles, search help content, and audit categories.
View
Suggestions
Foursquare AI Connector
Manage your location data — audit places, photos, and tips via AI.
ViewNASA Mars — Rover Photos from the Red Planet AI Connector
Browse 800,000+ photos taken on the surface of Mars by NASA rovers Curiosity, Opportunity, and Spirit — filter
ViewFamilySearch API AI Connector
Manage genealogical research — audit persons, pedigrees, and records via AI.
ViewRecreation.gov (RIDB) AI Connector
Access federal recreation data—find campgrounds, trails, and facilities across the US directly from your AI ag
View
