Best for
- Developers and ops teams already on Aiven who want AI-assisted resource management
- Teams managing both PostgreSQL and Kafka
- Security-conscious users who want a reduced tool surface (read-only, scoped)
A
Aiven MCP Server
Official
Manage the Aiven cloud data platform from your AI assistant
GitHub source repository ↗
64FMRS · C
An officially maintained, mature MCP server with comprehensive tool coverage (projects, service lifecycle, Kafka, PostgreSQL, application deployment) and solid safety controls such as read-only mode, tool scoping, and a write allowlist — a strong fit for Aiven customers managing their data infrastructure through AI assistants.
Aiven MCP Server is an officially maintained Model Context Protocol server for the Aiven cloud data platform. It lets AI assistants such as Claude, Cursor, and VS Code Copilot provision and manage PostgreSQL, Apache Kafka, and application deployments directly. It can run in two ways: as an Aiven-hosted remote HTTP server (OAuth authorization at https://mcp.aiven.live/mcp) or locally via npx mcp-aiven over stdio (requires Node.js 18+ and an AIVEN_TOKEN API token). It supports read-only mode, tool scoping by service (pg, kafka, application, integrations, core), and a write allowlist.
Tools
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 a Schema Registry subject version
aiven_pg_service_available_extensions
List available PostgreSQL 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 official Aiven documentation in natural language (hosted server only)
Setup
Remote (recommended): run claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp" in Claude Code, or add the URL in Cursor / VS Code MCP settings; the client will prompt you to authorize on Aiven via OAuth. Local stdio: requires Node.js 18+; create an API token at https://console.aiven.io/profile/tokens, then run claude mcp add --scope user aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven, or configure command npx with args ["-y","mcp-aiven"] and the AIVEN_TOKEN environment variable. Tool surface can be controlled via AIVEN_READ_ONLY, AIVEN_SERVICES_SCOPE, and related variables or URL query parameters.
claude_desktop_config.json
{"mcpServers":{"aiven-mcp":{"command":"npx","args":["-y","mcp-aiven"],"env":{"AIVEN_TOKEN":"your-token-here"}}}}
Fit and risk
Not for
- Users not on the Aiven platform
- Production environments where AI agents must not perform destructive actions (dropping databases, deleting services)
- Self-hosted/local deployments, which cannot use the aiven_docs_search tool
Required permissions
- Local stdio mode requires an Aiven API token (AIVEN_TOKEN)
- Remote mode uses OAuth authorization; access is governed by the Aiven user permissions of the authenticated account
- The server can only perform actions the Aiven user is allowed to do
Risks and side effects
- AI agents may execute destructive actions (dropping databases, deleting services, producing messages) based on their interpretation of prompts
- With AIVEN_ALLOW_SECRETS enabled, the connection-info tool returns live credentials (passwords, connection URIs, certs) into the conversation
- Review agent behavior, perform a risk assessment, and follow your organization's security policies before using in production
Troubleshooting
- Verify AIVEN_TOKEN is set correctly and valid (required for stdio mode)
- Local execution requires Node.js 18+
- Remote mode requires completing Aiven OAuth authorization in your MCP client
- If tools seem missing, check whether services_scope limits the exposed scope
- Cloud marketplace customers (AWS/Azure/GCP) must add the marketplace path segment, e.g. /mcp/aws
Use cases
Provision and manage PostgreSQL services through an AI assistant
Manage Apache Kafka topics, messages, and Connect connectors in natural language
Inspect service metrics, logs, query activity, and project events
Deploy and redeploy Dockerized applications
Safely browse Aiven projects and services in read-only mode
Supported clients
Claude CodeFull support
CursorFull support
VS Code / CopilotFull support