Skip to main content
Glama
Unsplash MCP Server

Unsplash MCP Server

by delbobauman

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
UNSPLASH_ACCESS_KEYYesYour Unsplash API access key

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_photosA

Search for photos on Unsplash by keyword.

Use this tool when you need to find photos for a specific topic or theme. Each result includes full attribution data that MUST be displayed when using the image (required by Unsplash API guidelines).

get_random_photosA

Get random photos from Unsplash, optionally filtered by keyword.

Use this tool when you need variety or don't have a specific image in mind. Great for hero images, backgrounds, or when you want to avoid repetitive results.

track_downloadA

Track a photo download (REQUIRED by Unsplash API guidelines).

You MUST call this function when a user downloads or saves a photo. This is required by Unsplash's API guidelines to properly credit photographers and track usage statistics.

Call this AFTER the user confirms they want to download/use the image, not when just displaying search results.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.8/5.0

Scored across 3 tools

Disambiguation4/5

search_photos and get_random_photos both retrieve photos and can both accept keywords, creating some potential overlap. However, their descriptions clearly distinguish deterministic search from random/variety-oriented retrieval, and track_download is a separate action.

Naming Consistency4/5

All tools use snake_case and begin with a verb, giving a mostly predictable pattern. get_random_photos is slightly more compound than the others, but the convention remains readable and consistent.

Tool Count5/5

Three tools is well-scoped for an Unsplash integration focused on photo discovery and required download tracking. Each tool has a clear, non-redundant role.

Completeness3/5

The set covers search, random discovery, and required download tracking, which are core workflows. However, it lacks a get_photo_by_id or equivalent operation for retrieving a specific photo directly, which is a notable gap for agents working with known photo identifiers.