# Unsplash

> Unsplash is a freemium MCP server for web search and scraping. Gateway-hosted MCP server for searching and retrieving Unsplash photos, users. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/unsplash
- **Repository:** https://github.com/pipeworx-io/mcp-unsplash
- **MCP Registry name:** io.github.pipeworx-io/unsplash
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http unsplash https://gateway.pipeworx.io/unsplash/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/unsplash/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unsplash": {
      "url": "https://gateway.pipeworx.io/unsplash/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unsplash": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/unsplash/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unsplash": {
      "serverUrl": "https://gateway.pipeworx.io/unsplash/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unsplash": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/unsplash/mcp"
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Pexels](https://ai-powered.com/mcp/pexels-3): Pexels is a freemium MCP server for design and media.
- [Wayback](https://ai-powered.com/mcp/wayback): Wayback is a freemium MCP server for web search and scraping.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [Tenor](https://ai-powered.com/mcp/tenor): Tenor is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/unsplash
