Provides tools for searching and retrieving photos from Unsplash with proper attribution, including search with filters (color, orientation), random photos, and download tracking, all compliant with Unsplash API guidelines.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@unsplash-mcp search for photos of mountain landscapes"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.

Photo by <a href="https://unsplash.com/@johndoe">John Doe</a> on <a href="https://unsplash.com">Unsplash</a>

# Clone the repository
git clone https://github.com/cevatkerim/unsplash-mcp.git
cd unsplash-mcp

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install fastmcp httpx python-dotenv

# Set your API key
echo "UNSPLASH_ACCESS_KEY=your_key_here" > .env

# Run the server
fastmcp run server.py

{
 "mcpServers": {
 "unsplash": {
 "type": "stdio",
 "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
 "args": ["run", "/path/to/unsplash-mcp/server.py"],
 "env": {
 "UNSPLASH_ACCESS_KEY": "your_access_key_here"
 }
 }
 }
}

{
 "mcpServers": {
 "unsplash": {
 "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
 "args": ["run", "/path/to/unsplash-mcp/server.py"],
 "env": {
 "UNSPLASH_ACCESS_KEY": "your_access_key_here"
 }
 }
 }
}

{
 "unsplash": {
 "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
 "args": ["run", "/path/to/unsplash-mcp/server.py"],
 "env": {
 "UNSPLASH_ACCESS_KEY": "your_access_key_here"
 }
 }
}

search_photos("mountain sunset", per_page=5, orientation="landscape")

get_random_photos(query="nature", count=3, orientation="landscape")

track_download("abc123xyz")

{
 "id": "abc123",
 "description": "A beautiful mountain landscape",
 "alt_description": "snow-capped mountains under blue sky",
 "urls": {
 "raw": "https://images.unsplash.com/...",
 "full": "https://images.unsplash.com/...",
 "regular": "https://images.unsplash.com/...", # Recommended for web
 "small": "https://images.unsplash.com/...",
 "thumb": "https://images.unsplash.com/..."
 },
 "width": 4000,
 "height": 3000,
 "color": "#a3c4f3", # Dominant color for placeholders
 "blur_hash": "LKO2?U%2Tw=w...", # For progressive loading

 # Attribution (REQUIRED when using the image)
 "photographer_name": "John Doe",
 "photographer_username": "johndoe",
 "photographer_url": "https://unsplash.com/@johndoe?utm_source=...",
 "photo_url": "https://unsplash.com/photos/abc123?utm_source=...",

 # Ready-to-use attribution
 "attribution_text": "Photo by John Doe on Unsplash",
 "attribution_html": "Photo by <a href=\"...\">John Doe</a> on <a href=\"...\">Unsplash</a>"
}