How to Use the APImage MCP in Windsurf

Q: Can I use APImage to fix prompts in Windsurf?

You can. The enhanceprompt tool refines your text before sending it to the generator. It saves you from trial and error when you need high-quality results.

Generate and edit media directly in Windsurf using Cascade to chain image tasks without manual oversight.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect APImage MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain image generation in Windsurf

Cascade takes your vision and runs `generate_image` to build assets on the fly. It handles the model selection via `list_models` so you don't waste time guessing settings. Once the output lands, use `upscale_image` or `remove_background` to refine the file. Windsurf sequences these calls so you get a finished asset in one go.

Modify existing files with Windsurf

Point Cascade at a local file and trigger `image_to_image` to iterate on your designs. It applies your prompt changes while maintaining the original composition. Need a specific patch fixed? The `inpaint_image` tool lets the agent target precise regions. It's the fastest way to alter photography inside your editor.

Manage your media history

Keep tabs on your work by running `list_generations` through the MCP server. You can pull back old drafts or verify status using `get_generation` to ensure every asset is accounted for. Checking connectivity is simple with `check_apimage_status`. If a prompt misses the mark, `enhance_prompt` helps you dial in better results before you commit to a new render.

Setup guide

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

mcp_config.json

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

Add the server to your settings file or use the built-in marketplace panel. Once connected, Cascade detects the tools and you can start generating images immediately.

Yes. You can script multiple calls to the server to process a folder of files. Cascade handles the logic while the server manages the heavy lifting.

You can. The `enhance_prompt` tool refines your text before sending it to the generator. It saves you from trial and error when you need high-quality results.

Your files stay local to your project. The server only processes the data you explicitly send to the API endpoints during a session.

Vinkius runs this MCP server in an ephemeral sandbox. No data persists on our end, and your proprietary photography stays within your local Windsurf workspace.

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