How to Use the Unsplash MCP in VS Code Copilot

Q: How do I integrate Unsplash with VS Code Copilot?

Add the server configuration via .vscode/mcp.json. Once committed, every developer on the team gets access to all photo tools and functions automatically through Copilot Chat.

Q: Can I use Unsplash to find inspiration while using VS Code Copilot?

Yes. You can ask the agent to run getrandomphoto to pull a quick visual reference or even list recent uploads with listlatestphotos. It keeps your code and context synchronized.

Get high-res photo assets for your team projects with VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect Unsplash to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Team-Wide Photo Asset Discovery via MCP Server

When defining requirements, the team can use `search_collections` to find appropriate visual topics by keyword. This ensures every developer gets access to a consistent, curated set of assets. The resulting list of collections and their IDs goes straight into your shared project config.

Retrieving Detailed Photo Metadata for Projects

Need specifics on an image? `get_photo_details` pulls all the metadata—like upload date, location data, or creator info. This prevents guesswork when setting up component props. You can also use `search_photos`, which returns photo IDs and URLs, making it easy to populate a list of assets across multiple files.

Building Out User Portfolios with Unsplash

To display an artist's work, the team can call `get_photographer_photos` using a username. This lists every photo uploaded by that user. For general inspiration or testing purposes, `get_random_photo` gives you a quick high-resolution image to verify your visual components.

Setup guide

Set up Unsplash MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Unsplash MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Unsplash tools listed. Try asking: "List my recent Unsplash transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "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 VS Code Copilot

Add the server configuration via `.vscode/mcp.json`. Once committed, every developer on the team gets access to all photo tools and functions automatically through Copilot Chat.

The MCP Server touches image URLs, collection IDs, photographer usernames, topic names, and structured metadata for every asset retrieved.

Yes. You can ask the agent to run `get_random_photo` to pull a quick visual reference or even list recent uploads with `list_latest_photos`. It keeps your code and context synchronized.

It's built into the team config. The MCP Server works within a shared, version-controlled environment, making it ideal for large engineering teams.

The Vinkius platform manages authentication via one endpoint token. Your team only needs to worry about the configuration file, not managing credentials manually.

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