
Unsplash
Gateway-hosted MCP server for searching and retrieving Unsplash photos, users
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Unsplash
Unsplash is a freemium MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.
The README describes this as an unofficial Unsplash integration run through the Pipeworx MCP gateway, which exposes Unsplash's photo search, single-photo lookups, random photos, editorial feeds, user profiles, collections and topics as callable tools. Each request goes to a hosted endpoint, so there is nothing to host locally unless you use the npm stdio bridge.
Beyond the Unsplash tools themselves, the hosted endpoint also lists shared gateway tools such as ask_pipeworx, which routes plain-English questions across other data sources. The README notes that the tool list therefore contains more entries than the Unsplash-specific set.
The server suits developers and agents that need Unsplash imagery inside an assistant or script without writing their own API client. Usage is metered: anonymous calls are capped daily, and a free Pipeworx key raises the limit.
Install
Run in a terminal
claude mcp add --transport http unsplash https://gateway.pipeworx.io/unsplash/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/unsplash/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"unsplash": {
"url": "https://gateway.pipeworx.io/unsplash/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"unsplash": {
"type": "http",
"url": "https://gateway.pipeworx.io/unsplash/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"unsplash": {
"serverUrl": "https://gateway.pipeworx.io/unsplash/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"unsplash": {
"type": "http",
"url": "https://gateway.pipeworx.io/unsplash/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- search_photos
- Search Unsplash photos by keyword.
- photo
- Fetch full metadata for a single photo by id.
- photo_random
- Retrieve one or more random photos with optional filters.
- photo_download
- Trigger the download-tracking event and return the download URL.
- photo_statistics
- Fetch view, download and like statistics for a photo.
- list_photos
- List the public editorial feed of curated photos.
- user
- Fetch the public profile for a username.
- user_photos
- List photos uploaded by a username.
- user_likes
- List photos liked by a username.
- collections
- List featured collections.
- collection
- Fetch metadata for a single collection.
- collection_photos
- List photos inside a collection.
- topics
- List editorial topics.
- topic
- Fetch metadata for a single topic by id or slug.
- topic_photos
- List photos belonging to a topic.
What it does
- Photo search and lookup
- Searches Unsplash by keyword and returns a single photo's image URLs, EXIF data, location and tags.
- Random photo retrieval
- Fetches one or more random photos with optional query, orientation, topic and collection filters.
- Collections and topics
- Lists featured collections and editorial topics, and pulls the photos inside each.
- User profiles and portfolios
- Reads a photographer's public profile and lists their uploads and liked photos.
- Download tracking
- Triggers Unsplash's required download event and returns the download URL before a link is shown.
- Photo statistics
- Returns view, download and like counts for a photo over a chosen time window.
Good for
- Finding stock photos by keyword from inside an AI assistant
- Pulling a random or themed image for a mockup or slide deck
- Browsing a photographer's portfolio or liked photos
- Collecting photos from a curated Unsplash topic or collection
- Checking how a photo performs using its view and download statistics
Pricing
Freemium, from $49 a month
Free anonymous and free account tiers; paid credits and subscriptions for higher usage
Prices change. Check pipeworx.io before you buy.
Unsplash FAQ
Is this an official Unsplash product?
No. The README says it is an independent, unofficial integration and is not affiliated with or endorsed by Unsplash.
Do I need an API key to use it?
No. Anonymous calls work but are capped at 50 per day. A free Pipeworx account raises the cap to 200 per day.
How do I connect it to my MCP client?
Add the hosted endpoint https://gateway.pipeworx.io/unsplash/mcp as a remote server, or run the npm package @pipeworx/mcp-unsplash via npx as a local stdio bridge.
Does the endpoint list only Unsplash tools?
By default the hosted endpoint also lists shared gateway tools such as ask_pipeworx. The npm bridge lists only Unsplash tools unless PIPEWORX_META_TOOLS=1 is set.
Is Unsplash free?
Unsplash has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Unsplash to Claude Code?
Run this command in your terminal: claude mcp add --transport http unsplash https://gateway.pipeworx.io/unsplash/mcp
What are the best alternatives to Unsplash?
The closest alternatives to Unsplash are Pexels, Wayback, Google_search_console and Tenor.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.