# Aiven-Open/mcp-aiven [Health: Active]

**Category:** 🗄️ Databases  
**Repository:** https://github.com/Aiven-Open/mcp-aiven  
**GitHub Stars:** 27  
**npm Downloads (last month):** 1563  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/aiven-open-mcp-aiven

## Description
Navigate your Aiven projects and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services

## Tools
Capabilities this server exposes over MCP:

- **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_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
- **aiven_pg_write** — Run a write SQL statement (INSERT, UPDATE, DELETE, CREATE TABLE, etc.)
- **aiven_pg_optimize_query** — AI-powered query optimization (EverSQL)
- **aiven_application_deploy** — Deploy a Dockerized application to Aiven
- **aiven_application_redeploy** — Rebuild and redeploy an existing application
- **aiven_vcs_integration_list** — List connected VCS (GitHub) accounts
- **aiven_vcs_integration_repository_list** — List repositories for a VCS integration
- **aiven_docs_search** — Search the official Aiven documentation in natural language. Only available on the hosted server (`https://mcp.aiven.live/mcp`) — not exposed in self-hosted deployments.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-aiven": {
    "command": "npx",
    "args": ["-y","mcp-aiven"],
    "env": {
      "AIVEN_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `AIVEN_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Aiven-Open/mcp-aiven MCP server does

Aiven-Open/mcp-aiven MCP server connects MCP-compatible clients with the Aiven cloud data platform. Its project and service tools can list projects, inspect project details, view available clouds and VPCs, enumerate services, compare service plans, check plan pricing, and create or update services. Service updates include plan, configuration, and power-state changes.

The server also exposes operational information for managed data and application services. Agents can fetch service metrics, application metrics, service logs, project event logs, and current queries for a service. The listed service types include PostgreSQL, Apache Kafka, ClickHouse, and OpenSearch, while the detailed Kafka tools cover topic and connector operations.

## How it works

Aiven-Open/mcp-aiven MCP server can run as a hosted HTTP MCP endpoint at `https://mcp.aiven.live/mcp`, or locally as a child process using stdio. In remote mode, the MCP client authorizes with Aiven and sends a bearer token with requests. In local stdio mode, the process uses an Aiven API token supplied through `AIVEN_TOKEN`.

Remote deployments support query parameters that change the exposed tool surface. `read_only=true` removes write operations, while `services_scope` can limit tools to areas such as Kafka, PostgreSQL, applications, integrations, or core discovery. A write allowlist can selectively restore named write tools in read-only mode. Marketplace users can use AWS, Azure, or Google Cloud marketplace path segments for sign-in.

## Setup and configuration

For local use, the documented package command is `npx -y mcp-aiven`, with Node.js 18 or later and `AIVEN_TOKEN` configured in the MCP client. The hosted endpoint can be added as an HTTP server in supported client configuration. Cursor and VS Code configuration examples are provided, and Claude Code has a command-line setup example.

Useful local environment settings include `AIVEN_READ_ONLY`, `AIVEN_SERVICES_SCOPE`, `AIVEN_WRITE_ALLOWLIST`, and `AIVEN_ALLOW_SECRETS`. The last option enables a connection-information tool that can return live credentials, passwords, connection URIs, and certificates; it is disabled in read-only mode. HTTP deployments can also configure the host, transport, request limits, and optional edge authentication.

## Tools and capabilities

- Discover Aiven projects, clouds, VPCs, services, plans, and pricing.
- Create services and change service plans, configuration, or power state.
- Retrieve metrics, logs, event history, and active queries.
- List, create, inspect, update, and delete Kafka topics.
- Read Kafka topic messages and produce new messages.
- List, create, edit, inspect, pause, resume, and restart Kafka connectors.

## Limitations and notes

Write-capable tools can create, modify, or delete services and data, including Kafka messages and topics. Access is limited by the authenticated Aiven user's permissions, but the agent may still perform consequential actions based on its interpretation of a prompt. Review proposed operations and follow organizational security procedures before using the server with production resources.

The hosted mode does not require `AIVEN_TOKEN` in the server environment because the client supplies a bearer token. Local mode does require the token. Enabling extra HTTP edge protection without matching Cloudflare configuration causes requests to fail, and enabling it without `MCP_EDGE_AUTH_SECRET` makes the process exit at startup.

_Full upstream README: https://allmcps.com/mcp/aiven-open-mcp-aiven/readme_