How to Use the Alai MCP in Windsurf

Generate studio-quality headshots and manage marketing campaigns directly inside Windsurf using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alai MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain campaign creation in Windsurf

Cascade handles the entire setup process without waiting for step-by-step instructions. Tell your agent to build a new team roster page, and it immediately hits `create_campaign` to set up the workspace. You do not have to manually approve every API call. Windsurf pulls available styles via `list_templates`, runs `generate_content` for each team member's selfie, and organizes the final portraits.

Autonomous asset management

Nobody wants to click through a web dashboard just to manage profile photos. This MCP integration lets your editor pull the raw images right into your local project environment. Cascade checks `get_generation` to monitor rendering progress in the background. Once the images finish processing, it fires `create_asset` to store the final studio-quality files exactly where your frontend code expects them.

Bulk database operations

Deleting old marketing materials is trivial when your editor talks directly to the database. You just ask to remove last year's holiday promo photos. The agent quickly runs `list_assets` to find the outdated files and executes `delete_asset` to clear them out. You sit back and watch the terminal output confirm the removals.

Setup guide

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

mcp_config.json

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

Open your MCP settings via the Cascade menu. Add the server details to the configuration file, then click refresh.

Yes. Cascade reads a directory of employee selfies, picks a style template, and runs the generation endpoints for every image without pausing.

The server processes the specific selfies you pass to the generation endpoints. Your local codebase remains entirely private during the rendering process.

Just tell Cascade to verify the connection. It will execute the `check_getalai_status` tool and report back if the API is reachable.

You only pay for completed portraits. If a generation times out while the agent polls the status, the API drops the request.

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