@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 search
  • photo(id) — single photo
  • photo_random(query?, count?, collections?, topics?, username?, orientation?, content_filter?) — random photo(s)
  • photo_download(id) — download tracker URL (use the returned url)
  • photo_statistics(id, resolution?, quantity?) — usage stats
  • list_photos(page?, per_page?, order_by?) — editorial feed
  • user(username) — user profile
  • user_photos(username, page?, per_page?, order_by?, stats?, resolution?, quantity?, orientation?) — user’s photos
  • user_likes(username, page?, per_page?, order_by?, orientation?) — user’s liked photos
  • collections(page?, per_page?) — list collections
  • collection(id) — single collection
  • collection_photos(id, page?, per_page?, orientation?) — photos in collection
  • topics(ids?, page?, per_page?, order_by?) — topics
  • topic(id_or_slug) — single topic
  • topic_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.

Regenerated from source · build July 9, 2026