How to Use the Aiven MCP in Windsurf

Q: How do I link Aiven to Windsurf?

Add the server entry to your /.codeium/windsurf/mcpconfig.json file. Once you restart the IDE, Windsurf detects the tools and makes them available to Cascade.

Q: Can Windsurf manage my Aiven billing?

Yes, you can monitor costs using listbillinggroups and listbillinggroupinvoices. It gives you a clear view of your spend directly in your development environment.

Q: Does the Aiven MCP server support team management?

It does. You can use listaccountteams and createaccountteam to manage access control lists without logging into the web console.

Manage your entire Aiven cloud stack directly inside Windsurf using autonomous agent flows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aiven MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate database provisioning

Cascade handles the heavy lifting when you need to spin up new infrastructure. It uses `create_service` to build your databases without you leaving the editor. Once the service is active, the agent confirms state via `get_service`. It keeps your environment definitions in sync with your local config files.

Monitor infrastructure within Windsurf

Stop jumping between browser tabs to check service health. The Aiven MCP server lets you run `list_services` to see what is running in your current project. If you need to change a plan or scale capacity, the agent executes `update_service` on your behalf. It handles the API handshake while you focus on the code.

Control project boundaries

Managing project access and VPC settings happens right in the chat pane. You can call `list_projects` to verify your workspace context before making changes. When it is time to isolate resources, `create_project_vpc` sets up your networking stack. Cascade maps the entire sequence, ensuring your environment is ready for deployment.

Setup guide

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

mcp_config.json

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

Add the server entry to your ~/.codeium/windsurf/mcp_config.json file. Once you restart the IDE, Windsurf detects the tools and makes them available to Cascade.

Yes, you can monitor costs using `list_billing_groups` and `list_billing_group_invoices`. It gives you a clear view of your spend directly in your development environment.

The server operates over local pipes or secure connections. It only accesses the specific resources you authorize via the MCP protocol, keeping your credentials separate from your codebase.

It does. You can use `list_account_teams` and `create_account_team` to manage access control lists without logging into the web console.

It touches metadata like project names, service configurations, and billing identifiers. The server never stores your private database content or raw connection strings permanently.

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