Manage Aiven services using MCP

The Aiven MCP server lets you create and manage services directly from AI assistants such as Cursor and Claude Code.

Prerequisites

• An Aiven account
• An organization with MCP access enabled
• An MCP-compatible client such as Cursor, Claude Code, Claude Desktop, or VS Code

MCP server URL

Use the following server URL when configuring your client:

https://aiven.io/mcp

Configure your MCP client

Cursor

Add to Cursor

Alternatively, add it manually:

1. In your project root, create or edit .cursor/mcp.json.

2. Add the following configuration:

   {
     "mcpServers": {
       "aiven": {
         "type": "http",
         "url": "https://aiven.io/mcp"
       }
     }
   }

3. Save the file.

4. Restart Cursor.

5. Open Settings > Tools & MCP.

6. Select aiven and click Connect.

Claude Code

1. Open a terminal.

2. Run the following command:

   claude mcp add --transport http aiven https://aiven.io/mcp

3. Run /mcp in Claude Code to verify the server is registered.

4. On first use, a browser window opens where you sign in to Aiven and select your organization.

For more information, see the Claude Code MCP documentation.

Claude Desktop

1. Open the Claude Desktop configuration file. If it does not exist, create it:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following to the configuration file:

   {
     "mcpServers": {
       "aiven": {
         "type": "http",
         "url": "https://aiven.io/mcp"
       }
     }
   }

3. Save the file and restart Claude Desktop.

For more information, see the Claude Desktop MCP documentation.

VS Code

note

Requires Visual Studio Code 1.102 or later with the GitHub Copilot extension installed and enabled.

1. Open your workspace in Visual Studio Code.

2. In the workspace root, create a .vscode directory if it does not exist.

3. In the .vscode directory, create or edit mcp.json.

4. Add the following configuration:

   {
     "servers": {
       "aiven": {
         "type": "http",
         "url": "https://aiven.io/mcp"
       }
     }
   }

5. Save the file.

6. Reload Visual Studio Code.

7. Open the Command Palette and run MCP: List Servers.

8. Confirm that aiven appears in the list.

For more information, see the VS Code MCP documentation.

Other clients

1. Open your MCP client configuration.

2. Add the Aiven MCP server using the following URL:

   https://aiven.io/mcp

Most clients accept a configuration similar to:

{
  "mcpServers": {
    "aiven": {
      "url": "https://aiven.io/mcp"
    }
  }
}

1. Save the file and restart your client.

Some clients require specifying the transport type, for example "type": "http". Refer to your client documentation if the configuration fails.

Verify the connection

Cursor

1. Open Cursor Chat with Cmd+L on macOS or Ctrl+L on Windows/Linux.

2. Try a prompt such as:

   List my Aiven projects.

3. If prompted to allow tool execution, click Allow.

4. To confirm the server is registered, go to Settings > Tools & MCP and check that aiven appears with a connected status.

Claude Code

1. Run /mcp in Claude Code to verify the server is registered.

2. Try a prompt such as:

   List my Aiven projects.

3. If prompted to allow tool execution, confirm.

Claude Desktop

1. Open a new conversation.

2. Verify that the MCP tools icon appears in the input area.

3. Try a prompt such as:

   List my Aiven projects.

4. If prompted to allow tool execution, click Allow.

VS Code

1. Open Copilot Chat in Visual Studio Code.

2. Open the Command Palette and run MCP: List Servers.

3. Confirm that aiven appears in the list.

4. Try a prompt such as:

   List my Aiven projects.

5. If prompted to allow tool execution, click Allow.

Other clients

1. Open your AI assistant.

2. Try a prompt such as:

   List my Aiven projects.

3. If prompted to allow tool execution, confirm.

4. Verify that the response includes information about your Aiven projects.

Authentication

The Aiven MCP server uses OAuth 2.0 with PKCE for authentication. When you first use the server, it opens a browser window where you sign in to Aiven and select your organization. The server manages token refresh automatically.

Supported tools

Service management

Create, update, and delete Aiven services across all supported service types. Browse available plans and pricing, view service metrics and logs, and manage service configurations and cloud regions.

PostgreSQL®

Create and manage PostgreSQL databases, execute read and write SQL queries, and manage PgBouncer connection pools. Get AI-powered query optimization recommendations, view query performance statistics, and list available extensions.

Apache Kafka®

Create and manage Kafka topics, produce and consume messages, and configure Kafka Connect connectors. Browse Schema Registry subjects and manage connector lifecycle operations including pause, resume, and restart.

Read-only mode

To restrict the server to read-only operations, set the AIVEN_READ_ONLY environment variable to true in your MCP client configuration:

{
  "mcpServers": {
    "aiven": {
      "type": "http",
      "url": "https://aiven.io/mcp",
      "env": {
        "AIVEN_READ_ONLY": "true"
      }
    }
  }
}

In read-only mode, the server only allows operations that read data, such as listing services, viewing metrics, and running SELECT queries. Write operations like creating services or modifying data are blocked.