Unsplash Connector for AI agents.

28 live capabilities

Find and manage high-resolution stock photos without leaving your chat.

Live agent request Unsplash / Connector

Waiting for input…

AI Agent

Why people use Unsplash

Unsplash for High-Resolution Stock Photo Discovery

With this Connector, you just tell your agent what you need. It searches the Unsplash library, filters by your preferences, and presents the best options in your chat. You get the right images immediately without ever leaving your workspace.

What Vinkius changes

You get direct access to a massive image library without ever leaving your AI chat.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Finding visual assets for a social campaign

A social media manager needs 5 photos of urban gardening.
Real-world use case 02

Exploring trending design styles

A designer wants to see what's trending in minimalist architecture.
Real-world use case 03

Analyzing photographer performance

A developer wants to see the stats for a specific photographer.

Complete set · 28capabilities

The complete Unsplash capability set.

These are the exact actions your AI can choose when you ask it to work with Unsplash.

Capability set01 / 07

01—04

4 capabilities in this set.

Part of 28 available through Unsplash.

01 Capability
Get photo
Get a single photo by its unique ID. This is useful for retrieving specific image details quickly.
02 Capability
Search users
Search for users on Unsplash using a keyword. Use this to find specific photographers or contributors.
03 Capability
Add photo to collection
Add a photo to a specific collection using your account. This helps you build your personal visual library.
04 Capability
List user photos
List all photos uploaded by a specific user. It is a great way to see a photographer's full portfolio.

Capability set02 / 07

05—08

4 capabilities in this set.

Part of 28 available through Unsplash.

05 Capability
Remove photo from collection
Remove a photo from a collection using your account. Use this to keep your curated folders organized.
06 Capability
Search collections
Search for public collections using a keyword. This helps you find curated groups of images from others.
07 Capability
Search photos
Search the Unsplash library for photos matching a keyword. This is the primary way to find new imagery.
08 Capability
Track photo download
Track a photo download for proper attribution. Use this to stay compliant with Unsplash API guidelines.

Capability set03 / 07

09—12

4 capabilities in this set.

Part of 28 available through Unsplash.

09 Capability
Create collection
Create a new photo collection using your account. This lets you group images by project or theme.
10 Capability
Delete collection
Delete a collection from your account. Use this to clean up your personal visual library.
11 Capability
Get collection photos
Get all photos inside a specific collection. This helps you see everything in a group at once.
12 Capability
Get collection
Get the details of a specific collection by its ID. Use this to see the metadata of a curated group.

Capability set04 / 07

13—16

4 capabilities in this set.

Part of 28 available through Unsplash.

13 Capability
Get me
Get your own authenticated profile information. Use this to check your current account status.
14 Capability
Get photo statistics
Get statistics for a specific photo. This shows you how many views and downloads an image has.
15 Capability
Get random photo
Get one or more random photos from the library. This is perfect for quick inspiration.
16 Capability
Get related collections
List related collections for a given collection ID. Use this to find similar visual themes.

Capability set05 / 07

17—20

4 capabilities in this set.

Part of 28 available through Unsplash.

17 Capability
Get topic photos
Get photos for a specific topic. This helps you find images categorized by the Unsplash editorial team.
18 Capability
Get topic
Get a single topic by ID or slug. Use this to see the details of a specific category.
19 Capability
Get user statistics
Get user download and view statistics. Use this to see the total reach of a specific user's content.
20 Capability
Get user
Get a user public profile. Use this to view the public details of any photographer.

Capability set06 / 07

21—24

4 capabilities in this set.

Part of 28 available through Unsplash.

21 Capability
Like photo
Like a photo on behalf of your account. This helps you curate your personal feed.
22 Capability
List collections
List all public collections. Use this to explore what other users are curating.
23 Capability
List photos
List photos from the editorial feed. This shows you what is currently trending on the platform.
24 Capability
List topics
List all topics. Use this to see the full range of categories available on Unsplash.

Capability set07 / 07

25—28

4 capabilities in this set.

Part of 28 available through Unsplash.

25 Capability
List user collections
List collections created by a user. Use this to see all your personal curated folders.
26 Capability
Unlike photo
Remove a like from a photo on behalf of your account. Use this to manage your liked content.
27 Capability
Update collection
Update an existing collection using your account. Use this to modify your curated folders.
28 Capability
Update me
Update your own profile information. Use this to manage your account details.

Set up in minutes

One URL. Then ask Unsplash to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Unsplash from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Unsplash, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Unsplash for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Unsplash URL.
Step 03

Save and start

Save the connection and enable Unsplash in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "unsplash-extended": {
      "url": "https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Unsplash

Open Agent mode in chat and ask: "Using Unsplash, help me...". 28 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "unsplash-extended": {
      "url": "https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Unsplash

Ask Copilot: "Using Unsplash, help me...". 28 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "unsplash-extended": {
      "url": "https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Unsplash

Open Cascade and ask: "Using Unsplash, help me...". 28 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "unsplash-extended": {
      "url": "https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Unsplash

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

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add unsplash-extended --transport http "https://edge.vinkius.com/vk_preview_fKBGHczIzZlTknCtrxQZKRbVfzKOlG1McKHHN2Rf/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Unsplash

Ask Claude: "Using Unsplash, show me...". 28 tools are ready

Where the request belongs

Work Unsplash can move forward.

Built around the request

This is for content creators, designers, and developers who need to find and organize high-quality visuals quickly without the friction of manual web searching.

01

Content Creator

You use this to find the perfect featured image for a blog post or social media campaign without switching tabs.

02

Graphic Designer

You pull high-resolution inspiration or placeholders into your design briefs using natural language commands.

03

Web Developer

You automate the retrieval of image metadata and statistics to populate content during application testing.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Unsplash

Manage your visual discovery. search photos, users, and collections via AI.

02 3 capabilities

Flickr Photo Discovery

Universal photography intelligence. search millions of public photos via AI.

03 12 capabilities

Flickr

Browse, search, and manage photo collections on Flickr with access to one of the largest creative photography communities online.

04 10 capabilities

Getty Images

Manage stock media via Getty Images. search millions of creative and editorial photos, handle video discovery, and download assets directly from any AI agent.

05 10 capabilities

Pexels

Retrieve free high-quality stock media via Pexels. search photos, track videos natively, and explore curated visual collections entirely through AI constraints.

Bring your own AI

Change the model, client or framework. Keep Unsplash connected.

Before you connect

Questions about Unsplash.

The practical details behind the request, access and result.

Can the Unsplash MCP find specific types of photos for my project?

Yes, it can search the entire Unsplash library using keywords, topics, and orientations. Your agent can find exactly what you need without you having to browse manually.

How do I manage my own collections with the Unsplash MCP?

You can create, update, and list your own personal collections. This lets you organize your favorite images into project-specific folders using just your voice or text.

Can I see how many times a photo has been downloaded?

Yes, the Connector can pull engagement statistics for specific photos. This is helpful for seeing which types of imagery are performing best.

Does the Unsplash MCP help with content inspiration?

It does. Your agent can pull random photos from specific topics or browse the editorial feed to show you what is currently trending in the design world.

Can I use the Unsplash MCP to organize my favorite images?

Absolutely. You can add photos to custom collections as you find them, making it easy to keep your visual assets organized by theme or project.

Is there a way to track photo downloads for attribution?

Yes, the Connector includes a capability to track photo downloads. This ensures you stay compliant with Unsplash's requirements for proper attribution.

Can I fetch a random photo based on a specific search term or topic?

Yes! Use the get_random_photo capability. You can provide a query (like 'nature') or topics IDs to filter the random selection to exactly what you need.

Is it possible to create and manage my own photo collections via the AI?

Absolutely. With a valid Bearer Token, you can use create_collection, add_photo_to_collection, and remove_photo_from_collection to curate your Unsplash assets directly through conversation.

How can I check the performance or popularity of a specific photo?

You can use the get_photo_statistics capability by providing the photo ID. It will return detailed metrics including total views and downloads.

One connection away

Give your agent a direct line to Unsplash.

Connect Unsplash once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available