Skip to content
appsgit

Aiven MCP

Aiven MCP is an MCP server that adds database tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Provision PostgreSQL, manage Apache Kafka, and deploy apps with Aiven - all from your AI assistant. It has 28 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y mcp-aiven.

github.com/Aiven-Open/mcp-aiven (opens in a new tab)

  • Official
  • Needs API key
  • Databases
  • Apache-2.0
  • Actively maintained

Install Aiven MCP

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "aiven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "your-value",
        "AIVEN_ALLOW_SECRETS": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env AIVEN_TOKEN=your-value --env AIVEN_ALLOW_SECRETS=your-value --transport stdio aiven-mcp -- npx -y mcp-aiven

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "aiven-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "your-value",
        "AIVEN_ALLOW_SECRETS": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "aiven_token",
      "description": "AIVEN_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aiven_allow_secrets",
      "description": "AIVEN_ALLOW_SECRETS",
      "password": true
    }
  ],
  "servers": {
    "aiven-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "${input:aiven_token}",
        "AIVEN_ALLOW_SECRETS": "${input:aiven_allow_secrets}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
AIVEN_TOKENsecretYesAiven API token (create one at https://console.aiven.io/profile/tokens)
AIVEN_READ_ONLYNoSet to true to expose only read-only tools
AIVEN_SERVICES_SCOPENoComma-separated scopes to expose (e.g. pg, kafka, pg,kafka, or all). Valid: all, core, pg, kafka, application, integrations.
AIVEN_ALLOW_SECRETSsecretNoSet to true to let the connection-info tool return live credentials instead of [REDACTED].

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • aiven_project_list

    List projects

  • aiven_project_get

    Get project details

  • aiven_list_project_clouds

    List cloud platforms for a project

  • aiven_project_vpc_list

    List VPCs for a project

  • aiven_service_list

    List services

  • aiven_service_type_plans

    List plans with cloud availability

  • aiven_service_type_get

    Get default and available engine versions for a service type

  • aiven_service_plan_pricing

    Get pricing for a plan in a specific cloud

  • aiven_service_create

    Create a service

  • aiven_service_get

    Get service information

  • aiven_service_update

    Update a service (plan, config, power state)

  • aiven_service_metrics_fetch

    Fetch metrics for managed data services

  • aiven_service_application_metrics_get

    Fetch metrics for application services

  • aiven_project_get_service_logs

    Get service log entries

  • aiven_service_query_activity

    Fetch current queries for a service

  • aiven_project_get_event_logs

    Get project event log entries

  • aiven_kafka_topic_list

    List Kafka topics

  • aiven_kafka_topic_create

    Create a Kafka topic

  • aiven_kafka_topic_get

    Get Kafka topic info

  • aiven_kafka_topic_update

    Update a Kafka topic

  • aiven_kafka_topic_delete

    Delete a Kafka topic

  • aiven_kafka_topic_message_list

    Read messages from a Kafka topic

  • aiven_kafka_topic_message_produce

    Produce messages into a Kafka topic

  • aiven_kafka_connect_available_connectors

    List available connector types

  • aiven_kafka_connect_list

    List running connectors

  • aiven_kafka_connect_create_connector

    Create a connector

  • aiven_kafka_connect_edit_connector

    Edit a connector

  • aiven_kafka_connect_get_connector_status

    Get connector status

  • aiven_kafka_connect_pause_connector

    Pause a connector

  • aiven_kafka_connect_resume_connector

    Resume a connector

  • aiven_kafka_connect_restart_connector

    Restart a connector

  • aiven_kafka_connect_delete_connector

    Delete a connector

  • aiven_kafka_schema_registry_subjects

    List Schema Registry subjects

  • aiven_kafka_schema_registry_subject_version_get

    Get Schema Registry subject version

  • aiven_pg_service_available_extensions

    List available extensions

  • aiven_pg_service_query_statistics

    Fetch query statistics

  • aiven_pg_bouncer_create

    Create a PgBouncer connection pool

  • aiven_pg_bouncer_update

    Update a PgBouncer connection pool

  • aiven_pg_bouncer_delete

    Delete a PgBouncer connection pool

  • aiven_pg_read

    Run a read-only SQL query

About Aiven MCP

A Model Context Protocol (MCP) server for the Aiven cloud data platform. Manage PostgreSQL, Apache Kafka, applications, and other Aiven services directly from AI assistants like Claude, Cursor, and VS Code Copilot.

FAQ

Aiven MCP FAQ

Still curious? Email info@appsgit.com.

What is Aiven MCP?

Aiven MCP is an MCP server that adds database tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Provision PostgreSQL, manage Apache Kafka, and deploy apps with Aiven - all from your AI assistant. It has 28 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y mcp-aiven. The source code is at github.com/Aiven-Open/mcp-aiven.

How do I install the Aiven MCP MCP server?

Add the command npx -y mcp-aiven to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Aiven MCP free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (AIVEN_TOKEN and AIVEN_ALLOW_SECRETS) for the service it connects to, which may require a paid account.

Is Aiven MCP actively maintained?

The most recent commit was on Oct 5, 2026. The latest release is v1.17.1, published Oct 6, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.