An MCP (Model Context Protocol) server for searching and fetching Unsplash photos with proper attribution. Built for LLM workflows that generate content pages and need compliant, ready-to-embed credits.
Overview
What is Unsplash MCP?
Unsplash MCP is a server designed to fetch high-quality Unsplash photos with proper attribution, specifically built for LLM workflows that generate content pages needing compliant, ready-to-embed credits.
How to use Unsplash MCP?
To use Unsplash MCP, clone the repository, set up a Python virtual environment, install the required packages, and run the server with your Unsplash API access key.
Key features of Unsplash MCP?
- Search photos by keyword with filters (color, orientation)
- Get random photos for variety in content
- Track downloads to comply with Unsplash API guidelines
- Full attribution included for every photo in both plain text and HTML formats
Use cases of Unsplash MCP?
- Integrating Unsplash images into web applications with proper attribution
- Generating content pages that require high-quality images
- Complying with Unsplash's attribution requirements while using their photos
FAQ from Unsplash MCP?
- Do I need an Unsplash API key to use this server?
Yes, an Unsplash API Access Key is required.
- Can I use Unsplash MCP for commercial projects?
Yes, as long as you provide proper attribution as required by Unsplash.
- Is there a limit to the number of photos I can fetch?
The Unsplash API has rate limits, so please refer to their documentation for details.
Server Config
{
"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"
}
}
}
}