Advertise
MCP.so
Sign In

Unsplash MCP Server

@cevatkerim

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

cevatkerim

Submitted by

Kerim Incedayi

About Unsplash MCP Server

An MCP server for Unsplash photo search with proper attribution built-in. Key differentiator: Returns ready-to-use attribution_text and attribution_html for each photo, making it trivial for LLMs to build content pages with properly credited images (as required by Unsplash API g

#unsplash#images#photos#stock-photos#attribution#mcp#fastmcp#python#llm#content#search

Unsplash MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Unsplash MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Unsplash Mcp?

An MCP (Model Context Protocol) server for fetching photos from Unsplash with proper attribution. It is designed for LLMs building content pages that need properly credited images.

How to use Unsplash Mcp?

Install Python 3.11+, obtain an Unsplash API access key, clone the repository, create a virtual environment, install dependencies (fastmcp, httpx, python-dotenv), set the key in a .env file, then run the server with fastmcp run server.py. Configure the server in your MCP client (e.g., Claude Code, Cursor, Windsurf/Cline) by providing the command path, arguments, and the UNSPLASH_ACCESS_KEY environment variable.

Key features of Unsplash Mcp

  • Search photos by keyword with filters (color, orientation)
  • Get random photos for variety in content
  • Download tracking compliant with Unsplash API guidelines
  • Full attribution including ready-to-use text and HTML
  • Pre-formatted attribution strings optimized for LLM embedding

Use cases of Unsplash Mcp

  • An LLM building a blog post includes credited landscape photos
  • A content-generation app selects a random nature image for a hero section
  • A website generator searches for coffee shop images and embeds attribution HTML
  • An AI assistant tracks downloads when a user saves an image

Frequently asked questions

1

What do I need to run Unsplash Mcp?

Python 3.11+ and an Unsplash API access key (available from unsplash.com/developers). Dependencies include fastmcp, httpx, and python-dotenv.

2

What are the rate limits?

Demo mode: 50 requests per hour. Production mode: 5,000 requests per hour (after approval).

3

Does the server handle Unsplash attribution requirements?

Yes. Every photo response includes `attribution_text` and `attribution_html` strings. You must use these when displaying images.

4

Can I hotlink images from Unsplash using this server?

Yes. The returned URLs are meant to be used directly, which enables view tracking in compliance with Unsplash API guidelines.

5

Do I need to track downloads?

Yes, if you offer a download link. Use the `track_download` tool with the photo ID to comply with Unsplash API guidelines.

Comments

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Advertise