How to Use the Dribbble MCP in Windsurf

Get your Dribbble portfolio updated automatically while Windsurf chains your design uploads and project organization.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dribbble MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Portfolio Sync via Windsurf

This MCP Server exposes tools like `create_shot` and `create_project` to let your agent manage your design assets without manual intervention. Cascade reads your local design directory, matches assets to your project structure, and pushes them to your profile in one clean run. The agent chains these actions by first checking your active work using `list_user_shots`, organizing them with `create_project`, and then uploading the final assets. You do not have to prompt each step; the agent handles the sequence on its own.

Granular Asset and Attachment Management

The `create_attachment` tool lets your agent attach raw source files or high-res assets directly to your existing shots. If a client needs the original Figma export or a PDF spec, the agent handles the upload under your Pro or Team membership. When you need to clean up old work, the agent uses `delete_attachment` or `delete_shot` to keep your portfolio current. You just tell the agent which project needs a refresh, and it handles the cleanup.

Instant Metadata and Project Updates

The `update_shot` and `update_project` tools modify your live Dribbble presentation on the fly. Your agent can rewrite descriptions, update tags, or shift shots between different showcase folders based on your feedback. If you manage team listings, the agent can also check on job postings using `get_job` and make quick edits with `update_job`. You get complete control over your design presence without opening a browser.

Setup guide

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

mcp_config.json

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

Cascade uses its autonomous planning capabilities to read your local files and execute a sequence of Dribbble MCP tools. It runs `create_shot` and then immediately attaches files using `create_attachment` in a single workflow.

Yes. You can tell Cascade to clean up your profile, and it will use `list_projects` to find empty folders and then execute `delete_project` on those targets. It handles the entire cleanup process in one go.

No, the Dribbble API does not support video uploads. Your agent can only upload standard image assets using the `create_shot` tool.

You need write and upload scopes authorized on your account. Tools like `create_shot` and `create_attachment` will fail if your token lacks these specific permissions.

Vinkius runs this server inside an ephemeral, zero-trust V8 sandbox. Your Dribbble portfolio assets, shot metadata, and access tokens are never saved or logged on our infrastructure, keeping your creative intellectual property secure.

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