How to Use the Pics.io MCP in Windsurf

Q: How do I search for files in Pics.io using Windsurf?

Run a natural language prompt in Cascade to trigger searchassets. The tool returns matching files, and Cascade can immediately fetch asset details using getasset to display them in your workspace.

Q: How does Windsurf handle comments on Pics.io assets?

Cascade runs listcomments to fetch feedback on any asset ID. If you need to reply, Cascade executes addcomment to post your notes directly back to the platform.

Q: Can I delete empty folders using this tool?

You can remove folders by calling deletecollection. Just have your agent check the folder contents first using listassets to avoid losing active files.

Manage and update your Pics.io media assets directly from Windsurf using Cascade's autonomous multi-step workflow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Pics.io MCP to Windsurf

Create your Vinkius account to connect Pics.io to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Pics.io with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate Asset Workflows in Windsurf

`list_assets` lets Cascade scan your media library to find files that need updates. Cascade runs this tool, checks the returned asset details, and prepares a plan to organize them without waiting for your manual confirmation. Once Cascade identifies the target files, this MCP Server can use `update_asset` to write tags or update metadata fields in one continuous operation. You get your assets updated in seconds instead of clicking through a web interface.

Structure Collections with Cascade

`create_collection` allows this MCP Server to build new directories for your creative teams on the fly. Cascade can automatically group assets by running `list_collections` to find existing structures, then creating new nodes based on your current project files. If a folder becomes obsolete, Cascade runs `delete_collection` to clean up your workspace. This keeps your Pics.io library organized without manual file management.

Track Revisions and Feedback

`list_revisions` exposes the history of your digital assets to Cascade so you can track changes over time. Your agent checks previous versions and compares them to ensure you are working with the correct file. Cascade uses `add_comment` to post feedback or log automated status updates directly to the asset. It can also pull existing feedback with `list_comments` to summarize team requests and execute edits based on those notes.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "picsio-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 Pics.io. 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 Pics.io 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 Pics.io MCP in Windsurf

Run a natural language prompt in Cascade to trigger `search_assets`. The tool returns matching files, and Cascade can immediately fetch asset details using `get_asset` to display them in your workspace.

Yes, Windsurf uses this MCP Server to chain actions together. Cascade can call `list_collections` to see your structure, then run `create_collection` to build new folders and `update_asset` to move files into place.

Cascade runs `list_comments` to fetch feedback on any asset ID. If you need to reply, Cascade executes `add_comment` to post your notes directly back to the platform.

You can remove folders by calling `delete_collection`. Just have your agent check the folder contents first using `list_assets` to avoid losing active files.

All asset metadata, collection names, and comments remain in a secure V8 sandbox. Your credentials and file details never touch third-party servers, keeping your creative assets isolated and safe.

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