# Aiven MCP

> Aiven MCP gives you natural language control over your open-source data infrastructure. You manage PostgreSQL, MySQL, Redis, Kafka, and more directly from your chat client. Instead of logging into multiple cloud consoles to provision databases or check service status, this MCP lets your AI agent handle everything—from creating entire accounts to monitoring billing groups.

## Overview
- **Category:** databases
- **Price:** Free
- **Tags:** managed-databases, postgresql, kafka, cloud-services, infrastructure-management

## Description

Managing modern data services means juggling dozens of dashboards and complex APIs across different cloud providers. This MCP changes that. It connects your chat client directly to your Aiven account, giving you full operational control without ever leaving the window where you're already chatting with your agent.

Need a new development environment? You can create an entire project, provision specific services like Kafka or PostgreSQL, and even set up networking components such as VPCs. It’s also great for compliance; check which organizations you belong to or list all projects under a given organization. If you use Vinkius to connect your AI client, this MCP makes sure managing complex data plumbing is something you talk through, not click through.

It lets you handle everything from basic team management—like inviting users or creating new accounts—to deep infrastructure tasks like terminating old services or updating project configurations. You just tell the agent what you need done with plain English.

## Tools

### add_card
Adds a credit card payment method to your user account.

### create_account_team
Creates a new team within an existing organizational account.

### create_account
Registers and creates an entirely new user account environment.

### create_billing_group
Sets up a new grouping structure used for monitoring invoices.

### create_project
Initializes and creates a brand-new project environment within an account.

### create_project_vpc
Builds a Virtual Private Cloud (VPC) for a specific project's secure network isolation.

### create_service
Deploys and provisions a new data service, like MySQL or Redis, into a project.

### delete_account
Removes an entire account environment if it is confirmed to be empty.

### delete_project
Deletes all resources belonging to a specific project.

### delete_service
Terminates an active data service, preventing further billing for it.

### get_account
Retrieves the full details and status of a specified account.

### get_project
Gets detailed information about a specific project, including its resources.

### get_service
Fetches all current operational details and status for an individual service.

### invite_organization_user
Adds a new user to the organization with defined access permissions.

### list_account_projects
Returns a list of all projects associated with a given account.

### list_account_teams
Shows all team structures belonging to the current account.

### list_accounts
Retrieves a list of all accounts that your user has access credentials for.

### list_billing_group_invoices
Pulls up the specific invoice records associated with a billing group.

### list_billing_groups
Lists all existing organizational billing groups available for management.

### list_cards
Retrieves a list of credit cards currently attached to the user profile.

### list_organization_projects
Shows all projects that are housed directly under the organization level.

### list_organization_vpcs
Retrieves a list of VPCs defined at the organizational scope.

### list_organizations
Shows all organizations that your user profile is part of.

### list_project_service_types
Displays all available database and service types you can deploy in a project.

### list_project_vpcs
Returns a list of VPCs that are configured for a specific project.

### list_projects
Shows all projects available to the user, regardless of their parent account.

### list_services
Lists every active service running within a specified project.

### update_account
Modifies the details or settings of an existing account.

### update_project
Changes configuration parameters for an already existing project.

### update_service
Updates specific operational configurations for a running data service.

## Prompt Examples

**Prompt:** 
```
List all Aiven accounts I have access to.
```

**Response:** 
```
I've retrieved your accounts. You have access to 'Primary-Org' (ID: acc123) and 'Dev-Sandbox' (ID: acc456).
```

**Prompt:** 
```
Show me the service types available for project 'ecommerce-prod'.
```

**Response:** 
```
For 'ecommerce-prod', you can deploy: pg (PostgreSQL), mysql, redis, kafka, opensearch, and clickhouse.
```

**Prompt:** 
```
List all active services in the project 'data-analytics'.
```

**Response:** 
```
I found 2 active services in 'data-analytics': 'pg-master' (PostgreSQL) and 'kafka-main' (Kafka). Both are currently in 'RUNNING' state.
```

## Capabilities

### Provision and manage data services
Deploy, configure, and update various open-source database types (PostgreSQL, MySQL, Redis) for specific projects.

### Handle full account lifecycle management
Create new accounts or delete empty ones, allowing you to organize your infrastructure environments at the highest level.

### Manage network connectivity
List and create Virtual Private Clouds (VPCs) for projects, ensuring secure and isolated connections between services.

### Oversee billing and user access
Monitor invoices across billing groups or invite new users into an organization to control who has access to what.

### Inspect existing infrastructure details
Retrieve full information about accounts, projects, services, or even list all available service types for a given project.

## Use Cases

### The SRE needs an infra audit
An SRE gets paged at 3 am. Instead of logging into the console and clicking through three separate sections to verify project status, they ask their agent: 'List all projects under the organization.' The agent runs `list_organization_projects` and provides a full list in seconds.

### The Dev needs a quick test environment
A backend developer realizes they need to test MySQL against a new dataset. They ask their agent, who uses the `create_project` tool to spin up a fresh project and then runs `create_service` for MySQL, giving them instant connection details.

### The Manager needs to onboard a team
A manager has new hires. Instead of emailing dozens of access links, they ask the agent to 'Invite John Doe to the organization.' The agent uses `invite_organization_user` and confirms the access was granted instantly.

### The Ops team needs to clean up old resources
An operations team member finds an unused development environment. They ask the agent to delete it. The agent checks for dependencies first, then uses `delete_project` and confirms termination, saving manual cleanup time.

## Benefits

- Stop context switching. You can check the status of a service using `get_service` or list projects with `list_account_projects`, all without leaving your conversation window.
- Control billing and access rights immediately. Use tools like `create_billing_group` or `invite_organization_user` to manage compliance records instantly from your chat client.
- Deploy services on demand. When you need a new database, simply tell the agent to `create_service`—whether it's PostgreSQL or Kafka—and get it running in a project.
- Scale infrastructure safely. You can list organization VPCs (`list_organization_vpcs`) before creating one with `create_project_vpc`, ensuring your data remains isolated and secure.
- Maintain clear records. Use `list_billing_group_invoices` to review costs without navigating through the billing dashboard manually.

## How It Works

The bottom line is that this MCP brings complex cloud management into your natural chat workflow.

1. First, subscribe to this MCP and provide your Aiven API Token.
2. Next, tell your AI agent what infrastructure task you need done—for example, 'List all projects under the organization.'
3. Finally, the agent executes the required commands using the available tools and presents you with the real-time results.

## Frequently Asked Questions

**How do I check my current services using Aiven MCP?**
You use the `list_services` tool to see all active data services in a project. This gives you an immediate overview of what's running and helps you confirm their status.

**Does Aiven MCP help me with billing? Which tools do I need?**
Yes, you can monitor costs using `list_billing_group_invoices` or list all billing groups via `list_billing_groups`. This keeps your spending visible right where you are working.

**Can Aiven MCP create a new project?**
Absolutely. You use the `create_project` tool to initialize and set up an entirely new development or testing environment within your account structure.

**What if I need to delete resources using Aiven MCP?**
You must be careful, but you can terminate things with tools like `delete_service` or remove entire environments using `delete_project`. Always double-check the scope first.

**Which accounts does Aiven MCP let me see?**
You run `list_accounts` to retrieve a list of every account you have access credentials for, ensuring you don't miss any environments.