How to Use the Image Router MCP in Windsurf

Q: What happens if a generation fails?

The server provides clear feedback. You can use checkimagerouterstatus to see if the API is reachable or if there's a specific issue with the model endpoint.

Stop guessing which model to use. Let Windsurf automatically route your image generation tasks to the best engine for the job.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Image Router MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automatic model selection for Windsurf

Windsurf uses this MCP Server to analyze your prompt requirements before firing off a generation. It skips the manual selection process entirely. By calling `list_models_by_category`, the agent identifies the perfect architecture for your specific visual goal without needing your input.

Chain complex generation workflows

Cascade doesn't just trigger one tool; it builds a sequence. It can start with `generate_image`, verify completion via `get_generation_status`, and then move straight to `upscale_image`. This creates a hands-off pipeline where you define the final output and Windsurf handles the heavy lifting between model endpoints.

Granular style control

Access the exact visual aesthetic you need by checking `list_styles` before you start. The server maps these styles to specific backend models. Use `generate_image_advanced` when you need to tweak parameters beyond a simple text prompt. You get professional results without leaving your editor.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "image-router-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 Image Router. 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 Image Router 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 Image Router MCP in Windsurf

It acts as a backend bridge. Once you add the server to your MCP config, Windsurf gains the ability to talk to multiple image models through a unified set of tools.

Yes. You can instruct your agent to loop through a list of prompts. It will call `generate_image` for each one and track progress using `get_generation_status`.

Not at all. Beyond simple generation, you get full control over variations and edits using `generate_variation` and `edit_image` directly in your workspace.

The server provides clear feedback. You can use `check_imagerouter_status` to see if the API is reachable or if there's a specific issue with the model endpoint.

Your prompts are sent directly to the selected image model backend. We don't store your generation history or image data on our servers.

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