What can you do with this server?

The Aiven MCP Server allows you to interact with your Aiven account and services through these key functions: * List Projects: Retrieve all projects associated with your Aiven account. * List Services: Get a list of all services (like PostgreSQL, Kafka, etc.) within a specified project (requires project_name). * Get Service Details: Obtain detailed information about a specific service in a project (requires both project_name and service_name).

Which integrations are available for this server?

Provides access to Aiven for ClickHouse services, allowing interaction with analytical databases hosted on the Aiven platform. Enables working with Aiven for OpenSearch services, providing tools to interact with search and analytics capabilities. Enables interaction with Aiven for PostgreSQL services, allowing access to database resources hosted on the Aiven platform.

How do I use Aiven MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Aiven MCP Server list all my Aiven projects" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Aiven MCP Server

Official

by Aiven-Open

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

Aiven MCP Server

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.

WARNING

Use with care. This MCP server can create, modify, and delete Aiven services and data on your behalf. AI agents may execute destructive actions (dropping databases, deleting services, producing messages) based on their interpretation of your prompts. You are fully responsible for the actions taken through this tool.

Permissions: Access is governed by the Aiven user permissions associated with the authenticated account. The MCP server can only perform actions that your Aiven user is allowed to do.

AI Agent Security: AI agents may need access credentials (database connection strings, streaming tokens) to act on your behalf. Review what your agent is doing, especially in production environments. Follow your organization's security policies and do a risk assessment before giving AI agents access to sensitive resources.

Quick Start

Option 1: Remote (hosted by Aiven)

The MCP server is hosted at https://mcp.aiven.live/mcp. Your MCP client will prompt you to authorize on Aiven.

Claude Code

claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp"

Cursor

Install MCP Server

Or manually add to Cursor MCP settings:

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp"
    }
  }
}

VS Code / Copilot

Add to .vscode/mcp.json in your workspace:

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

Read-Only Mode (Remote)

Enable read-only mode by adding ?read_only=true to the URL. All write operations will be excluded from the MCP:

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?read_only=true"
    }
  }
}

Scoped Tools (Remote)

Reduce the tool surface exposed to your AI agent by adding ?services_scope= to the URL. Useful when you only work with a subset of Aiven services and want to keep the agent's context focused. Combine values with commas. core (project/service discovery) is always included implicitly.

Valid scopes: all, core, pg, kafka, application, integrations. Use all to explicitly load every tool (same as omitting the param). all cannot be combined with other scopes.

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?services_scope=kafka"
    }
  }
}

You can also combine with read_only:

https://mcp.aiven.live/mcp?services_scope=pg&read_only=true

Marketplace Customers (Remote)

If you subscribed to Aiven through a cloud marketplace, add your marketplace as a path segment so sign-in uses the correct console:

Marketplace	Path segment
AWS Marketplace	`https://mcp.aiven.live/mcp/aws`
Azure Marketplace	`https://mcp.aiven.live/mcp/azure`
Google Cloud Marketplace	`https://mcp.aiven.live/mcp/gcp`

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp/<marketplace>"
    }
  }
}

The path segment combines with the query parameters above, for example https://mcp.aiven.live/mcp/gcp?services_scope=pg&read_only=true.

Option 2: stdio (local)

Run the server locally as a child process of your MCP client. Requires Node.js 18+.

You must provide your Aiven API token via the AIVEN_TOKEN environment variable. Create a token here.

Claude Code

claude mcp add --scope user aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven

Cursor, VS Code -- add to your MCP client config:

{
  "mcpServers": {
    "aiven-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-aiven"],
      "env": {
        "AIVEN_TOKEN": "your-token-here"
      }
    }
  }
}

Config file locations:

Cursor: Cursor Settings > MCP Servers
VS Code: .vscode/mcp.json in your workspace

Option 3: Local development

Run a local build of the server (useful for development and testing):

pnpm install && pnpm generate:api-types && pnpm generate && pnpm build && AIVEN_TOKEN="<YOUR_TOKEN>" MCP_TRANSPORT="http" PORT=3000 node dist/index.js

The server listens on port 3000 by default. Connect your MCP client to http://localhost:3000/mcp.

To point a remote deployment at a custom host (e.g. your local build), set MCP_HOST:

MCP_HOST=http://localhost:3000 node dist/index.js

Environment Variables

Variable	Required	Default	Description
`AIVEN_TOKEN`	stdio only	--	Aiven API token (create one here)
`AIVEN_READ_ONLY`	No	`false`	Set to `true` to expose only read-only tools
`AIVEN_SERVICES_SCOPE`	No	--	Comma-separated scopes to expose (e.g. `kafka`, `pg,kafka`, or `all`). Valid: `all`, `core`, `pg`, `kafka`, `application`, `integrations`. `core` is always included. Omitting the var or setting `all` loads every tool.
`AIVEN_ALLOW_SECRETS`	No	`false`	Set to `true` to expose the `aiven_service_connection_info` tool, which returns live credentials (passwords, connection URIs, certs) into the conversation. Disabled while `AIVEN_READ_ONLY=true`.
`MCP_HOST`	No	`https://mcp.aiven.live`	Override the OAuth protected resource host
`MCP_TRANSPORT`	No	`stdio`	Set to `http` to start an HTTP server instead of stdio
`MCP_HTTP_RATE_LIMIT_MAX`	No	`1000`	Max requests per window on `POST /mcp` (HTTP transport). Applies independently to a per-bearer-token bucket and a per-source-IP bucket; whichever fills first returns 429.
`MCP_HTTP_RATE_LIMIT_WINDOW_MS`	No	`60000`	Window length in milliseconds for `MCP_HTTP_RATE_LIMIT_MAX`.

In remote (HTTP) mode, AIVEN_TOKEN is not needed. Your MCP client sends your token as a Bearer token with each request.

Related MCP server: MCP TapData Server

Tools

Core

Tool	Description
`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

Kafka

Tool	Description
`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

PostgreSQL

Tool	Description
`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)

Applications

Tool	Description
`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

Documentation

Tool	Description
`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.

Contributing

See CONTRIBUTING.md for development setup, running locally, and adding new tools.

License

Apache-2.0

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2dRelease cycle

24Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Appeared in Searches

Latest Blog Posts

Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Aiven-Open/mcp-aiven'

If you have feedback or need assistance with the MCP directory API, please join our Discord server