MCP server exposing 15 tools for unsplash.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/unsplash/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}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.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/unsplash/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io