@pipeworx/unsplash
Connect: https://gateway.pipeworx.io/unsplash/mcp · Install: one-click buttons
Tools: 15
Unsplash MCP — photo search, photos, users, collections. Free demo key 50 req/hr (production approval = 5000/hr).
Auth
- Platform:
PLATFORM_UNSPLASH_KEY. BYO:?_apiKey=…(Unsplash access key).
Tools
search_photos(query, page?, per_page?, order_by?, collections?, content_filter?, color?, orientation?)— photo searchphoto(id)— single photophoto_random(query?, count?, collections?, topics?, username?, orientation?, content_filter?)— random photo(s)photo_download(id)— download tracker URL (use the returnedurl)photo_statistics(id, resolution?, quantity?)— usage statslist_photos(page?, per_page?, order_by?)— editorial feeduser(username)— user profileuser_photos(username, page?, per_page?, order_by?, stats?, resolution?, quantity?, orientation?)— user’s photosuser_likes(username, page?, per_page?, order_by?, orientation?)— user’s liked photoscollections(page?, per_page?)— list collectionscollection(id)— single collectioncollection_photos(id, page?, per_page?, orientation?)— photos in collectiontopics(ids?, page?, per_page?, order_by?)— topicstopic(id_or_slug)— single topictopic_photos(id_or_slug, page?, per_page?, orientation?, order_by?)— photos in topic
Data source
https://api.unsplash.com
Tools
- search_photos — Search Unsplash photos by keyword (required); returns paginated results with image URLs, dimensions, photographer info, and alt text.
- photo — Fetch full metadata for a single Unsplash photo by id, including all image URLs (raw, full, regular, small, thumb), EXIF, location, tags, and photographer.
- photo_random — Retrieve one or more random Unsplash photos; supports optional filters (query, orientation, collections, topics, username, content_filter) passed as extra params.
- photo_download — Trigger the Unsplash required download-tracking event for a photo by id and return the download URL; must be called before presenting the download link to users per Unsplash API guidelines.
- photo_statistics — Fetch view, download, and like statistics for a single Unsplash photo by id; supports resolution (“days”) and quantity (1–30) to control the time-series window.
- list_photos — Fetch Unsplash’s public editorial feed of recently curated photos in chronological or popular order; returns paginated photo objects with URLs and metadata.
- user — Fetch the public Unsplash profile for a given username, including bio, location, follower/following counts, total photos/likes/collections, and portfolio URL.
- user_photos — List photos uploaded by a specific Unsplash username; returns paginated photo objects with image URLs, likes, and metadata.
- user_likes — List photos that a specific Unsplash username has liked; returns paginated photo objects with image URLs, photographer, and metadata.
- collections — List featured Unsplash collections in paginated order; returns collection id, title, description, total photos, cover photo, and curator info.
- collection — Fetch metadata for a single Unsplash collection by id, including title, description, total photos, tags, cover photo, and curator profile.
- collection_photos — List photos inside a specific Unsplash collection by id; returns paginated photo objects with image URLs and metadata.
- topics — List Unsplash editorial topics (curated content channels like “nature”, “architecture”); returns topic id, slug, title, description, cover photo, and curator.
- topic — Fetch metadata for a single Unsplash topic by id or slug (e.g. “animals”), including title, description, total photos, cover photo, and top contributors.
- topic_photos — List photos belonging to a specific Unsplash topic by id or slug; returns paginated photo objects with image URLs, EXIF, and photographer info.
Tools
-
collection— Fetch metadata for a single Unsplash collection by id, including title, description, total photos, tags, cover photo, and curator profile. -
collection_photos— List photos inside a specific Unsplash collection by id; returns paginated photo objects with image URLs and metadata. -
collections— List featured Unsplash collections in paginated order; returns collection id, title, description, total photos, cover photo, and curator info. -
list_photos— Fetch Unsplash's public editorial feed of recently curated photos in chronological or popular order; returns paginated photo objects with URLs and metadata. -
photo— Fetch full metadata for a single Unsplash photo by id, including all image URLs (raw, full, regular, small, thumb), EXIF, location, tags, and photographer. -
photo_download— Trigger the Unsplash required download-tracking event for a photo by id and return the download URL; must be called before presenting the download link to users per Unsplash API guidelines. -
photo_random— Retrieve one or more random Unsplash photos; supports optional filters (query, orientation, collections, topics, username, content_filter) passed as extra params. -
photo_statistics— Fetch view, download, and like statistics for a single Unsplash photo by id; supports resolution ( days ) and quantity (1–30) to control the time-series window. -
search_photos— Search Unsplash photos by keyword (required); returns paginated results with image URLs, dimensions, photographer info, and alt text. -
topic— Fetch metadata for a single Unsplash topic by id or slug (e.g. animals ), including title, description, total photos, cover photo, and top contributors. -
topic_photos— List photos belonging to a specific Unsplash topic by id or slug; returns paginated photo objects with image URLs, EXIF, and photographer info. -
topics— List Unsplash editorial topics (curated content channels like nature , architecture ); returns topic id, slug, title, description, cover photo, and curator. -
user— Fetch the public Unsplash profile for a given username, including bio, location, follower/following counts, total photos/likes/collections, and portfolio URL. -
user_likes— List photos that a specific Unsplash username has liked; returns paginated photo objects with image URLs, photographer, and metadata. -
user_photos— List photos uploaded by a specific Unsplash username; returns paginated photo objects with image URLs, likes, and metadata.