home / mcp / unsplash mcp server

Unsplash MCP Server

Provides search, retrieval, and random photo access from Unsplash via an MCP server.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "okooo5km-unsplash-mcp-server-go": {
      "command": "unsplash-mcp-server",
      "args": [],
      "env": {
        "UNSPLASH_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

Available tools

search_photos

Searches Unsplash for photos matching a keyword with optional filters such as page, per_page, order_by, color, and orientation.

get_photo

Fetches detailed information about a specific photo by its ID, including EXIF data and photographer details.

random_photo

Returns one or more random photos with optional filters like collections, topics, username, query, orientation, content_filter, and featured.