Skip to content
MCP server

Unsplash

Gateway-hosted MCP server for searching and retrieving Unsplash photos, users

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/unsplash/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "unsplash": {
      "url": "https://gateway.pipeworx.io/unsplash/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers