How to Use the Unsplash Extended MCP in Windsurf

Q: Can Unsplash Extended and Windsurf handle photo management?

Yeah. You can create entire collections using createcollection or update existing ones with updatecollection. It's all exposed through the MCP Server so Cascade knows exactly what it's doing.

Q: Does Unsplash Extended and Windsurf handle multiple users?

Yes. You can check public profiles using getuser, or see your own stats with getme. The MCP Server manages user authentication so the actions are tied to a specific account.

Q: Can I list all photo topics with Unsplash Extended and Windsurf?

Absolutely. Use listtopics to get an exhaustive rundown of available themes. This gives you keywords for later searches or when planning asset groups via the MCP Server.

Manage massive photo libraries with Unsplash Extended, automatically via Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Unsplash Extended MCP to Windsurf

Create your Vinkius account to connect Unsplash Extended to Windsurf 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 Extended with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Content Discovery for Windsurf

Need a set of high-res images for a project? Just tell your goal to Cascade. It'll check topics using `get_topic_photos`, find related collections with `get_related_collections`, and even pull random inspiration via `get_random_photo`. You don't have to chain those calls manually.

Managing Unsplash Collections in Windsurf

Keep your project assets organized. Cascade handles the whole workflow: you can create a new grouping with `create_collection`, search existing ones using `search_collections` by keyword, and then populate it instantly. Don't forget to track usage when you use `add_photo_to_collection`.

Tracking User Activity with Unsplash Extended

When your users download photos, you gotta know about it for attribution. This MCP Server lets Windsurf call `track_photo_download`, which is critical for reporting. Plus, if you need to see who's viewing or downloading stuff, `get_user_statistics` gives you those numbers.

Setup guide

Set up Unsplash Extended MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Unsplash Extended MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Unsplash Extended payment history." If connected, Cascade will call the Unsplash Extended tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "unsplash-extended-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 Extended 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 Extended MCP in Windsurf

Just set the goal. Cascade will automatically run searches using `search_photos` based on your request, giving you a list of relevant images right in the context pane. This means less manual prompting.

Yeah. You can create entire collections using `create_collection` or update existing ones with `update_collection`. It's all exposed through the MCP Server so Cascade knows exactly what it's doing.

The server handles photo metadata, including IDs, topics, and user-uploaded content. Specifically, `add_photo_to_collection` requires knowing the unique photo ID.

Yes. You can check public profiles using `get_user`, or see your own stats with `get_me`. The MCP Server manages user authentication so the actions are tied to a specific account.

Absolutely. Use `list_topics` to get an exhaustive rundown of available themes. This gives you keywords for later searches or when planning asset groups via the MCP Server.

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