How to Use the Unsplash MCP in Cline

Q: How do I get photo IDs using Unsplash with Cline?

You run the searchphotos tool in your terminal. The output is structured, providing not only URLs but also the unique photo ID you can then use to fetch specific details later via other tools.

Q: Can I automate finding collections using Unsplash in Cline?

Absolutely. You run searchcollections with your desired keywords. The resulting IDs let you build a map of related content that you can then process through other parts of your CI/CD pipeline.

Q: If I need attribution details, what Unsplash provides for Cline?

The searchphotos tool explicitly requires and returns proper attribution information. You can write scripts that enforce this metadata check before committing any asset links to your codebase.

Build visual dashboards with Cline. Automate photo sourcing directly in your terminal environment.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Unsplash MCP to Cline

Create your Vinkius account to connect Unsplash to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Unsplash with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

MCP Server: Programmatic image retrieval for Cline

Use `search_photos` to programmatically query Unsplash and get a clean output of IDs, URLs, and required attribution data. This is perfect for scripting—you write the call, it returns structured JSON you can pipe into another build step. You don't have to manually look up assets. You just run the search command in your terminal, and Cline handles the API interaction, giving you raw, usable data sets.

Build image-dependent components with MCP Server for Cline

Need a component that displays all photos from one specific set? Call `list_collection_photos` after finding the necessary Collection ID. This outputs an array of photo IDs you can use to populate your local database or API endpoint. If you need details on those photos later, you feed those IDs into `get_photo_details`. Cline processes this data stream, making it ready for consumption in your code.

Source assets via MCP Server and Cline

Start with a broad concept. Run `search_collections` using keywords like 'Industrial' or 'Nature.' This gives you the necessary IDs to scope down your search. Then, if you need inspiration outside of collections, use `get_random_photo`. The output is immediately usable in your scripts; it’s not just a link—it’s data ready for immediate processing.

Setup guide

Set up Unsplash MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type unsplash-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Unsplash refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

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

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Unsplash. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Unsplash now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Unsplash MCP in Cline

You run the `search_photos` tool in your terminal. The output is structured, providing not only URLs but also the unique photo ID you can then use to fetch specific details later via other tools.

The server touches photo metadata (IDs, URLs), photographer usernames, and collection structures. Since this is a CLI tool, all output is meant to be consumed by subsequent code or scripts.

Absolutely. You run `search_collections` with your desired keywords. The resulting IDs let you build a map of related content that you can then process through other parts of your CI/CD pipeline.

Yes. When combined with the ability to list multiple photos via `list_collection_photos`, you can feed thousands of photo IDs into a script, making it ideal for large-scale data work.

The `search_photos` tool explicitly requires and returns proper attribution information. You can write scripts that enforce this metadata check before committing any asset links to your codebase.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript