Unsplash

liveArtMedia

Unsplash — search and retrieve high-resolution free stock photos, user profiles, collections, and editorial topics.

15tools
0msauth
free tier50 calls/day

Tools

search_photos

Search Unsplash photos by keyword (required); returns paginated results with image URLs, dimensions, photographer info, and alt text.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
photo_random

Retrieve one or more random Unsplash photos; supports optional filters (query, orientation, collections, topics, username, content_filter) passed as extra params.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
user

Fetch the public Unsplash profile for a given username, including bio, location, follower/following counts, total photos/likes/collections, and portfolio URL.

No parameters required.

▶Try it
user_photos

List photos uploaded by a specific Unsplash username; returns paginated photo objects with image URLs, likes, and metadata.

No parameters required.

▶Try it
user_likes

List photos that a specific Unsplash username has liked; returns paginated photo objects with image URLs, photographer, and metadata.

No parameters required.

▶Try it
collections

List featured Unsplash collections in paginated order; returns collection id, title, description, total photos, cover photo, and curator info.

No parameters required.

▶Try it
collection

Fetch metadata for a single Unsplash collection by id, including title, description, total photos, tags, cover photo, and curator profile.

No parameters required.

▶Try it
collection_photos

List photos inside a specific Unsplash collection by id; returns paginated photo objects with image URLs and metadata.

No parameters required.

▶Try it
topics

List Unsplash editorial topics (curated content channels like "nature", "architecture"); returns topic id, slug, title, description, cover photo, and curator.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/unsplash/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/unsplash/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_photos","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_photos", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("unsplash — search and retrieve high-resolution free stock photos, user profiles, collections, and editorial topics");