Can it automatically fetch 5 relevant images based on an abstract concept and give me direct URLs?

Yes. Command the LLM using 'search_photos' with a query like 'Serenity' and 'per_page: 5'. It leverages the native search algorithm to bring back structured output containing precise image hotlinks alongside the photographers' names for attribution.

If I am building a mock UI, can it provide a purely random high-res placeholder image?

A perfect use case! Instruct the AI to call 'get_random_photo'. It skips conventional heavy searches pulling one brilliant, random massive resolution photo. You can even filter the chaos slightly (e.g., random 'architecture').

How do I ensure I get photos only from a specific trusted photographer I like?

If you know their handle, fire off the 'get_photographer_photos' payload. The bot will bypass generic listings entirely, retrieving paginated bundles of art exclusively captured and uploaded by that precise account profile natively.

Unsplash MCP Server for Cline 10 tools — connect in under 2 minutes

Name: Unsplash
Availability: InStock
Author: Vinkius

cline.bot/docs/mcp

Built by Vinkius GDPR 10 Tools IDE

Cline is an autonomous AI coding agent inside VS Code that plans, executes, and iterates on tasks. Wire Unsplash through the Vinkius and Cline gains direct access to every tool — from data retrieval to workflow automation — without leaving the terminal.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Unsplash and 2,500+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "unsplash": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Unsplash MCP Server

Connect the Unsplash photography ecosystem to any AI agent and take full autonomous control over discovering, indexing, and retrieving high-resolution imagery and curated collections native to your chat interface.

Cline operates autonomously inside VS Code — it reads your codebase, plans a strategy, and executes multi-step tasks including Unsplash tool calls without waiting for prompts between steps. Connect 10 tools through the Vinkius and Cline can fetch data, generate code, and commit changes in a single autonomous run.

What you can do

Intelligent Image Search — Query the global massive library using natural language to extract direct photo IDs, resolution properties, and immediate HD links
Curated Collection Auditing — Dive into thematic human-curated folders grabbing entire bundles of contextual visuals natively via API search_collections
Random Inspiration Hooks — Prompt the LLM to pluck out absolutely random high-res visuals based on subtle conceptual inputs finding the elusive perfect placeholder
Photographer Telemetry — Isolate public artists retrieving entire portfolios tracking the search_users capabilities inherently within your workspace

The Unsplash MCP Server exposes 10 tools through the Vinkius. Connect it to Cline in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Unsplash to Cline via MCP

Follow these steps to integrate the Unsplash MCP Server with Cline.

Open Cline MCP Settings

Click the MCP Servers icon in the Cline sidebar panel

Add remote server

Click "Add MCP Server" and paste the configuration above

Enable the server

Toggle the server switch to ON

Start using Unsplash

Ask Cline: "Using Unsplash, help me..." — 10 tools available

Why Use Cline with the Unsplash MCP Server

Cline provides unique advantages when paired with Unsplash through the Model Context Protocol.

Cline operates autonomously — it reads your codebase, plans a strategy, and executes multi-step tasks including MCP tool calls without step-by-step prompts

Runs inside VS Code, so you get MCP tool access alongside your existing extensions, terminal, and version control in a single window

Cline can create, edit, and delete files based on MCP tool responses, enabling end-to-end automation from data retrieval to code generation

Transparent execution: every tool call and file change is shown in Cline's activity log for full visibility and approval before committing

Unsplash + Cline Use Cases

Practical scenarios where Cline combined with the Unsplash MCP Server delivers measurable value.

Autonomous feature building: tell Cline to fetch data from Unsplash and scaffold a complete module with types, handlers, and tests

Codebase refactoring: use Unsplash tools to validate live data while Cline restructures your code to match updated schemas

Automated testing: Cline fetches real responses from Unsplash and generates snapshot tests or mocks based on actual payloads

Incident response: query Unsplash for real-time status and let Cline generate hotfix patches based on the findings

Unsplash MCP Tools for Cline (10)

These 10 tools become available when you connect Unsplash to Cline via MCP:

get_collection_details

Retrieves details for a specific photo collection

get_photo_details

Retrieves details for a specific Unsplash photo

get_photographer_photos

Lists photos uploaded by a specific Unsplash user

get_random_photo

Optionally provide a query to narrow the random selection. Retrieves a random high-resolution photo

list_collection_photos

Requires a collection ID. Lists all photos contained within a specific collection

list_editorial_topics

Lists curated editorial topics (Nature, Architecture, etc.)

list_latest_photos

Lists the most recently uploaded photos on Unsplash

search_collections

g. "Nature", "Industrial"). Search for curated photo collections by keyword

search_photographers

Search for Unsplash photographers by name or username

search_photos

Returns photo IDs, URLs, and photographer information. Note: Proper attribution is required. Search Unsplash for free high-resolution photos

Example Prompts for Unsplash in Cline

Ready-to-use prompts you can give your Cline agent to start working with Unsplash immediately.

"Search for 3 high resolution images containing 'cyberpunk city' aesthetics and provide their URLs natively in your response."

"Grab a random photo matching 'coffee desk concept' to help me prototype a blog layout."

"I need to see what's trending. Quickly gather the 10 most recently published latest photos off the main feed."

Troubleshooting Unsplash MCP Server with Cline

Common issues when connecting Unsplash to Cline through the Vinkius, and how to resolve them.

Server shows error in sidebar

Click the server name to see logs. Verify the URL and token are correct.

Unsplash + Cline FAQ

Common questions about integrating Unsplash MCP Server with Cline.

How does Cline connect to MCP servers?

Cline reads MCP server configurations from its settings panel in VS Code. Add the server URL and Cline discovers all available tools on initialization.