Aiven Authentication & Onboarding
This skill ensures the user is authenticated with Aiven before any operation can proceed. It runs as a multi-turn conversation — each step ends by waiting for a user reply before continuing.
All Aiven tools live on the plugin:aiven:aiven MCP server.
Entry points
This skill triggers in two situations — the flow differs slightly:
The user asked to get started — this includes direct skill invocation (e.g. /aiven:aiven-getting-started) as well as natural language like "how do I set up Aiven", "I'm new to Aiven", "how to start using Aiven", "connect my account".
→ Follow the full onboarding flow starting at Step 1. You MUST reach Step 2 (the Welcome message) if Step 1 fails — never stop at Step 1 with troubleshooting advice.
An Aiven MCP tool call failed (authentication error, tools unavailable, or the user asked to perform an Aiven action but the tools aren't connected) → The user has a task in progress. Acknowledge what they asked for, then run the onboarding flow to unblock it. After authentication succeeds, resume their original request — pick up where the tool call failed rather than asking "what would you like to do?"
Step 1: Check authentication
Try to call aiven_project_list on server plugin:aiven:aiven with no parameters. This is the fastest way to check if the user is already connected.
Success → If the user had a pending task (e.g., "create a pg service"), resume that task now by calling the appropriate Aiven tools. If there was no pending task, say:
Your Aiven account is connected! You have access to [N] projects. Here's what I can help you with:
- Build and deploy an application on top of your data services (PostgreSQL, Kafka, and more)
- Explore your existing services and data
- Create new data services or manage existing ones
What would you like to do?
Then wait for the user's reply.
Failure (any kind) → Whether the call returns an auth error, the tools aren't available, the MCP server isn't connected, or the call fails for any other reason — move to Step 2 silently. Do NOT try to troubleshoot the MCP connection or give auth instructions yet. Just proceed to Step 2.
Step 2: Ask about existing account
The user might be brand new to Aiven or might already have an account. Ask first so the response is relevant:
Welcome to Aiven — Easily deploy managed databases, streaming, and apps, such as: PostgreSQL, Kafka, OpenSearch, and more.
Do you already have an Aiven account?
Wait for the user's reply — the next step depends on their answer.
Step 3: Guide based on answer
User has an account → Connect it:
Let's connect your account.
Then give auth instructions for their IDE:
- Cursor: Go to Settings → Tools & MCP, find the "aiven" Plugin MCP Server, and click authenticate.
- Claude Code: Run
/plugin, go to Installed, select "aiven MCP", and press Enter to auth.
Then:
Once you've authenticated, just send me a message and I'll verify the connection.
Wait for the user's reply.
User needs a new account → Show the signup link first, then what's included:
No problem! You can create your free account here — no credit card needed:
→ https://console.aiven.io/signup
Here's what you get for free:
- PostgreSQL or MySQL — 1 GB storage, 1 GB RAM, 20 connections
- Apache Kafka — 250 kb/s throughput, 3-day retention, 5 topics
- OpenSearch — 20 GB storage, 4 GB RAM, 20 shards
- Valkey — 1 GB RAM
You also get $300 in free trial credits to try any service at full scale for 30 days.
After you've created your account and verified your email, just send me a message and I'll help you connect the plugin.
Wait for the user's reply.
User declines →
No worries! Whenever you're ready, just ask me to help you get started with Aiven.
Step 4: Verify connection
When the user replies after authenticating, call aiven_project_list to verify the connection — just check directly rather than asking if they've finished.
If it works and the user had a pending task, resume it now — call the appropriate Aiven tools to fulfill the original request. Otherwise, say:
You're connected to Aiven! Here are some things I can help you with:
- Build and deploy an app — with managed databases and streaming, up and running in minutes
- Create free-tier services — PostgreSQL, MySQL, Kafka, OpenSearch, Valkey, and more
What would you like to do?
Guidelines
- Keep the conversation friendly and low-pressure. The free tier requires no credit card.
- Always verify authentication by calling
aiven_project_list— it's the source of truth. - Each step waits for a user reply before continuing. This keeps the conversation natural and avoids overwhelming the user with information they didn't ask for.
