How to Use the Flickr MCP in Windsurf

Q: Can Windsurf search for photos using the Flickr API?

Yes. It uses the searchphotos tool to query the entire public database directly from your editor. You get the results back as structured data ready for your code.

Q: How does Windsurf handle Flickr album data?

It calls getuseralbums to fetch a list of sets for any user ID. Once you have the album ID, you can use getalbumphotos to pull the actual image links.

Q: Will Windsurf automatically fetch Flickr metadata?

Absolutely. You can tell Cascade to run getphotoinfo on a specific image ID. It extracts the details and brings them into your active file.

Windsurf connects directly to Flickr, giving Cascade the power to pull real-time photography data into your codebase.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Flickr MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous photo discovery for Windsurf

Cascade uses `search_photos` and `get_recent_photos` to find imagery without manual browser jumping. It pulls metadata directly into your current project context. This MCP Server lets you script visual assets into your UI components. You define the search parameters, and the agent handles the rest.

Deep dive into Flickr metadata via Windsurf

Get the technical specs for any shot using `get_photo_info`. It reveals technical details that help you build accurate image-heavy applications. You can also run `get_hot_tags` to see what's trending. This keeps your project aligned with current visual movements.

Manage user galleries within Windsurf

Use `get_user_albums` to list collections and `get_album_photos` to grab specific sets. It simplifies how you import gallery data into your apps. Your agent can query `get_user_popular_tags` for a specific creator. This maps out exactly what content defines their portfolio.

Setup guide

Set up Flickr 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 Flickr 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 Flickr payment history." If connected, Cascade will call the Flickr tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "flickr-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 Flickr. 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 Flickr 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 Flickr MCP in Windsurf

Yes. It uses the `search_photos` tool to query the entire public database directly from your editor. You get the results back as structured data ready for your code.

It calls `get_user_albums` to fetch a list of sets for any user ID. Once you have the album ID, you can use `get_album_photos` to pull the actual image links.

Absolutely. You can tell Cascade to run `get_photo_info` on a specific image ID. It extracts the details and brings them into your active file.

Yes. You need your own API credentials to connect the server. Once configured, Windsurf handles the communication protocol.

The server only touches public data via the API. Your private credentials remain local to your config file and are never sent to third-party servers.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python