Unsplash Go MCP Server

Search Unsplash photos, inspect a photo and retrieve random images with okooo5km’s Go MCP server. Supports stdio and self-hosted SSE.

Local serverstdiosseGo

What is the Unsplash Go MCP Server?

This Go MCP server connects an assistant to Unsplash photo search and retrieval. It provides search filters, individual photo details and random photo selection.

Find an image for a defined brief

Start with a subject, orientation and colour preference. Review the returned photo and photographer details before choosing an image for a page or presentation.

Run the local binary

Download the maintainer’s release or build from source. Add the executable to your client configuration and set UNSPLASH_ACCESS_KEY. Stdio is the default; SSE is an optional self-hosted mode.

Follow the current project

The former Swift repository now redirects to this Go project. Use the current README for setup rather than the outdated repository summary.

Maintainer documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_photosSearch with photo filters.
get_photoRetrieve details for a photo.
random_photoRetrieve a random selection.

How to install the Unsplash Go MCP Server

{
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server",
      "env": {
        "UNSPLASH_ACCESS_KEY": "YOUR_UNSPLASH_ACCESS_KEY"
      }
    }
  }
}

Install the binary first and replace the placeholder with your own Unsplash access key.

Configuration

Install the project binary and configure an Unsplash API access key.

VariableDescriptionRequired
UNSPLASH_ACCESS_KEYYour Unsplash API access key.Yes

Example prompts to try

  • “Use Unsplash to search photos.”
  • “Use Unsplash to get photo.”
  • “Use Unsplash to random photo.”

Frequently asked questions

It is a Go MCP server that exposes Unsplash photo search, retrieval, and random photo tools for use by LLMs and other MCP clients.