Skip to main content
Glama
hanoak

@hanoak/unsplash-mcp-server

by hanoak
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoLog level: debug, info, warn, error (default info)
UNSPLASH_APP_NAMENoYour registered Unsplash app name, used as the attribution utm_source. Defaults to a generic value if unset.
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
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
find_photoSearch Unsplash for a photo matching a description and present it with attribution.

Resources

Contextual data attached and managed by the client

NameDescription
attribution-guideHow to correctly attribute and use Unsplash photos from this server: attribution, download tracking, hotlinking, and content safety.

Latest Blog Posts

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