How to Use the Docker Hub MCP in Windsurf

Q: How do I connect the Docker Hub MCP Server to Windsurf?

Add the server configuration to your /codeium/windsurf/mcpconfig.json file under the mcpServers key. Once saved, Cascade auto-discovers the tools and lets you query your Docker Hub registries immediately.

Q: Can Cascade create private registries on Docker Hub using Windsurf?

Yes. Cascade calls the createrepository tool and passes the private visibility parameter directly through the Windsurf interface.

Q: Can I search public images in Windsurf using this server?

The searchrepositories tool allows you to find public Docker Hub images directly from the Windsurf chat pane. Cascade uses this to suggest base images for your Dockerfiles.

Let Windsurf and Cascade manage your Docker Hub registries, search images, and update tags without manual terminal switching.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Docker Hub MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inspect image tags directly from Windsurf

The `list_tags` tool lets Windsurf query your remote registry to find specific image tags and digests without leaving your editor. Cascade reads your workspace configuration, detects which image your code targets, and pulls the exact tag metadata to verify you are deploying the correct build. Instead of manually running shell commands to check if an image exists, Cascade handles this in the background. It matches your local workspace edits to remote image availability instantly, keeping your deployment references accurate.

Automated registry setup with Windsurf MCP Server

The `create_repository` tool allows Windsurf to set up new public or private registries on Docker Hub as soon as your code is ready. Cascade chains this action when you generate a new service, creating the repository and running `update_repository` to apply descriptions before you even trigger your build. You define the architecture, and Cascade configures the destination. By automating the registry setup, your agent keeps your cloud setup in sync with your local codebase without manual configuration steps.

Smart organization and repository audits

The `list_organizations` tool retrieves your associated Docker Hub teams so Windsurf can verify access before attempting pushes. Cascade uses this data alongside `list_repositories` to audit your active images, identifying outdated or unused repositories that require cleanup. If your workspace references a missing repository, Cascade flags it. It runs `get_repository` to verify the namespace, ensuring your configuration files point to valid endpoints before you commit.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "docker-hub-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 Docker Hub. 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 Docker Hub 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 Docker Hub MCP in Windsurf

Add the server configuration to your `~/codeium/windsurf/mcp_config.json` file under the `mcpServers` key. Once saved, Cascade auto-discovers the tools and lets you query your Docker Hub registries immediately.

Yes. Cascade calls the `create_repository` tool and passes the private visibility parameter directly through the Windsurf interface.

Windsurf executes requests directly through the configured server, which respects standard Docker Hub API rate limits. If you hit a limit, Cascade displays the API error directly in your chat window.

The `search_repositories` tool allows you to find public Docker Hub images directly from the Windsurf chat pane. Cascade uses this to suggest base images for your Dockerfiles.

Your personal access tokens and registry metadata remain inside the Vinkius secure sandbox. Windsurf accesses the tools via a secure, single-token endpoint, meaning your raw credentials never expose themselves to the LLM context.

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