Unsplash MCP Server

What is Unsplash MCP Server?

Unsplash MCP Server is a Go implementation of the Model Context Protocol that enables LLMs to search, retrieve, and get random photos from Unsplash’s extensive photo library. It provides tools like search_photos, get_photo, and random_photo and is built for developers integrating Unsplash imagery into AI assistants.

How to use Unsplash MCP Server?

Install a pre-built binary from GitHub Releases or build from source with Go 1.20+. Set the UNSPLASH_ACCESS_KEY environment variable with your Unsplash API access key. Run the server by executing unsplash-mcp-server (default stdio mode) or use --transport sse for web-based connections. Configure the server for Claude, Cursor, or Chatwise by adding it to their MCP settings.

Key features of Unsplash MCP Server

• Advanced image search with keyword, color, orientation, and ordering filters
• Detailed photo information including EXIF data and photographer details
• Random photo selection with optional count, collection, topic, and query filters
• Support for stdio and Server-Sent Events (SSE) transport modes
• Paginated search results and configurable items per page (1–30)

Use cases of Unsplash MCP Server

• Search for high-quality photos by keyword, color, or orientation during conversations
• Retrieve full metadata (EXIF, location, photographer) for a specific Unsplash photo
• Generate random images based on topics, collections, or search terms for inspiration
• Integrate visual search capabilities into LLM-based content creation workflows