MCP server

Unsplash

io.github.pipeworx-io/unsplash

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Unsplash MCP.

Website Source

At a glance

Type

MCP server

Publisher

pipeworx.io (verified by the MCP Registry)

Status

Working at last check

Tools

57

Token cost

About 27,689 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http unsplash https://gateway.pipeworx.io/unsplash/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.unsplash]
url = "https://gateway.pipeworx.io/unsplash/mcp"

Gemini CLI

{"mcpServers":{"unsplash":{"httpUrl":"https://gateway.pipeworx.io/unsplash/mcp"}}}

Cursor

{"mcpServers":{"unsplash":{"url":"https://gateway.pipeworx.io/unsplash/mcp"}}}

VS Code

{"servers":{"unsplash":{"type":"http","url":"https://gateway.pipeworx.io/unsplash/mcp"}}}

Antigravity

agy mcp add unsplash https://gateway.pipeworx.io/unsplash/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"unsplash","server_url":"https://gateway.pipeworx.io/unsplash/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"unsplash","server_url":"https://gateway.pipeworx.io/unsplash/mcp"}

Tools

• collection ~86 tokens
  Fetch metadata for a single Unsplash collection by id, including title, description, total photos, tags, cover photo, and curator profile.
• collection_photos ~88 tokens
  List photos inside a specific Unsplash collection by id; returns paginated photo objects with image URLs and metadata.
• collections ~75 tokens
  List featured Unsplash collections in paginated order; returns collection id, title, description, total photos, cover photo, and curator info.
• list_photos ~82 tokens
  Fetch Unsplash's public editorial feed of recently curated photos in chronological or popular order; returns paginated photo objects with URLs and metadata.
• photo ~89 tokens
  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 ~102 tokens
  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 ~80 tokens
  Retrieve one or more random Unsplash photos; supports optional filters (query, orientation, collections, topics, username, content_filter) passed as extra params.
• photo_statistics ~129 tokens
  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 ~99 tokens
  Search Unsplash photos by keyword (required); returns paginated results with image URLs, dimensions, photographer info, and alt text.
• topic ~95 tokens
  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 ~100 tokens
  List photos belonging to a specific Unsplash topic by id or slug; returns paginated photo objects with image URLs, EXIF, and photographer info.
• topics ~80 tokens
  List Unsplash editorial topics (curated content channels like "nature", "architecture"); returns topic id, slug, title, description, cover photo, and curator.
• user ~94 tokens
  Fetch the public Unsplash profile for a given username, including bio, location, follower/following counts, total photos/likes/collections, and portfolio URL.
• user_likes ~95 tokens
  List photos that a specific Unsplash username has liked; returns paginated photo objects with image URLs, photographer, and metadata.
• user_photos ~92 tokens
  List photos uploaded by a specific Unsplash username; returns paginated photo objects with image URLs, likes, and metadata.

Browse

• GitHub tools
• GitHub and code hosting
• Government and public data

Related MCP servers

• Micah Boswell
  Facts about Micah Boswell, product design leader in Dallas: work, writing, photography, profiles.
• QuintaDB
  No-code databases, forms, portals and AI sites. Manage records and automation via natural language.
• QuintaDB
  No-code databases, forms, portals and AI sites. Manage records and automation via natural language.
• Rightshold
  License checks, signed rights proof, keyless pre-call checks for MCP servers, and the agent store
• SVG Lab
  SVG Lab MCP: the Design Engine for AI. App screens, icons, illustrations and charts as SVG.
• Unsplash MCP Server
  MCP server for the Unsplash API: search & fetch photos with attribution + download tracking.
• Image Resolver
  MCP server for context-aware royalty-free image search from Pexels and Unsplash
• Stock Images MCP
  Search and download free stock images from Pexels, Unsplash, and Pixabay.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.pipeworx-io/unsplash.svg)](https://aptlynx.net/servers/io.github.pipeworx-io/unsplash)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents