Unsplash
Search and use free stock photos from Unsplash. Over 3 million high-resolution images. Attribution required.
setup_integration or the Dashboard Vault — they're encrypted
with AES-256-GCM and never exposed.
Required Credentials
Get your API key at unsplash.com →
Endpoints (4)
Search Unsplash for photos by keyword. Returns up to 10 results with URLs, photographer name, and download links.
| Field | Type | Required | Description |
|---|---|---|---|
query |
string | ✓ Yes | Search query (e.g. "mountain landscape", "office workspace"). |
orientation |
string | No | Photo orientation: "landscape", "portrait", or "squarish". Default: any. |
Get full details for an Unsplash photo: high-res URLs, photographer, description, EXIF data, and download link.
| Field | Type | Required | Description |
|---|---|---|---|
photo_id |
string | ✓ Yes | Unsplash photo ID (e.g. "abc123XYZ"). |
Get a random Unsplash photo. Optionally filter by search query. Great for hero images and backgrounds.
| Field | Type | Required | Description |
|---|---|---|---|
query |
string | No | Optional keyword filter (e.g. "nature", "technology"). |
orientation |
string | No | Photo orientation: "landscape", "portrait", or "squarish". |
Trigger a download event for a photo. Required by Unsplash Terms of Service when using a photo. Use the download_location URL from search/get results.
| Field | Type | Required | Description |
|---|---|---|---|
download_location |
string | ✓ Yes | The download_location URL from the photo's links object. Example: "https://api.unsplash.com/photos/abc123/download". |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| search-photos | unsplash_search_photos |
| get-photo | unsplash_get_photo |
| random-photo | unsplash_random_photo |
| track-download | unsplash_track_download |