Schema | @hanoak/unsplash-mcp-server

@hanoak/unsplash-mcp-server

Overview Schema Related Servers Score Discussions

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description
`LOG_LEVEL`	No	Log level: debug, info, warn, error (default info)
`UNSPLASH_APP_NAME`	No	Your registered Unsplash app name, used as the attribution utm_source. Defaults to a generic value if unset.
`UNSPLASH_ACCESS_KEY`	Yes	Your Unsplash API access key

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": true }
`prompts`	{ "listChanged": true }
`resources`	{ "listChanged": true }

Tools

Functions exposed to the LLM to take actions

Name	Description
unsplash_random_photo	Fetch a single random photo from Unsplash. Optionally filter by search term, orientation, collections, topics, or user. Returns photo URLs, dimensions, color, and ready-to-use attribution (text + HTML). Content is filtered to "high" safety by default. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_list_photos	List the latest featured Unsplash photos (paginated). Returns compact photo objects with URLs and ready-to-use attribution. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_get_photo	Get a single Unsplash photo by its ID or slug, with full detail, URLs, and ready-to-use attribution. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_photo_statistics	Get download and view totals for a photo over the last N days (default 30). Read-only.
unsplash_track_download	Register a download for a photo when it is actually used/displayed, as required by Unsplash's API guidelines. Pass the `download_location` URL from a prior photo result. Returns a fresh, usable image download URL. This has a side effect (it counts toward the photographer's download stats), so it is NOT read-only — call it only on real use.
unsplash_search_photos	Search Unsplash photos by keyword, with optional filters (orientation, color, order, collections, language). Returns paginated compact photos with URLs and ready-to-use attribution. Content is filtered to "high" safety by default. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_search_collections	Search Unsplash collections by keyword. Returns paginated compact collections (title, description, cover photo, curator). Read-only.
unsplash_search_usersA	Search Unsplash users by keyword. Returns paginated compact user profiles (name, username, bio, profile link, photo/collection counts). Read-only.
unsplash_get_user	Get an Unsplash user's public profile by username. Read-only.
unsplash_user_photosA	List a user's photos (paginated), with URLs and ready-to-use attribution. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_user_collections	List a user's collections (paginated). Read-only.
unsplash_user_statistics	Get a user's download and view totals over the last N days (default 30). Read-only.
unsplash_list_collections	List the latest featured Unsplash collections (paginated). Read-only.
unsplash_get_collection	Get a single Unsplash collection by its ID. Read-only.
unsplash_collection_photosA	List the photos in a collection (paginated), with URLs and ready-to-use attribution. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_related_collections	List collections related to a given collection. Read-only.
unsplash_list_topics	List Unsplash topics (curated themes), paginated. Read-only.
unsplash_get_topicA	Get a single Unsplash topic by its ID or slug. Read-only.
unsplash_topic_photosA	List the photos in a topic (paginated), with URLs and ready-to-use attribution. Read-only. Each photo includes a `raw` imgix base URL — append params for a custom size/format, e.g. `?w=800&h=600&q=80&fm=webp&fit=crop` — plus fixed `full`/`regular`/`small`/`thumb` sizes.
unsplash_total_statsA	Get Unsplash-wide totals: photos, downloads, views, photographers, and more. Read-only.
unsplash_month_statsA	Get Unsplash-wide totals for the past 30 days: new photos, downloads, views, and more. Read-only.

Prompts

Interactive templates invoked by user choice

Name	Description
`find_photo`	Search Unsplash for a photo matching a description and present it with attribution.

Resources

Contextual data attached and managed by the client

Name	Description
`attribution-guide`	How to correctly attribute and use Unsplash photos from this server: attribution, download tracking, hotlinking, and content safety.

Server Configuration
Capabilities
Tools
Prompts
Resources

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hanoak/unsplash-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server