Unsplash MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UNSPLASH_ACCESS_KEY | Yes | Your 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
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.
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.
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.
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.