# Unsplash

> Use this tool when you need to discover and retrieve high-quality stock photos with structured metadata for content creation, design mockups, or visual inspiration. It solves problems of image sourcing and curation through keyword-based search, curated collections, and random image generation, with inputs including search terms and filters, and outputs featuring detailed photo metadata and download links. Ideal for AI assistants requiring flexible and relevance-based image access with comprehensive error handling.

Canonical page: https://skillsregistry.net/skills/gzpaitch-unsplash  
JSON: https://api.skillsregistry.net/v1/skills/gzpaitch-unsplash

## Description

FastAPI-based MCP server that exposes the Unsplash API through three core tools: search_photos for keyword-based image discovery with relevance and recency sorting, get_photos for retrieving curated collections with popularity-based ordering, and get_random_photos for generating random images optionally filtered by search terms. Built by gzpaitch using FastAPI-MCP integration with pandas for data processing and comprehensive error handling, the implementation provides detailed photo metadata including photographer information, engagement metrics, download links, and technical specifications across multiple image resolutions. Designed for AI assistants requiring access to high-quality stock photography for content creation, design mockups, or visual inspiration workflows where structured metadata and flexible search capabilities are essential.

## Trust

- **Trust score (0–1):** 0.97
- **Verification tier:** verified
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** media
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/gzpaitch-unsplash)
- **Repository:** <https://github.com/gzpaitch/unsplash-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "gzpaitch-unsplash"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/gzpaitch-unsplash` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/gzpaitch-unsplash/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt