Aiven MCP Server

Name: Aiven MCP Server
Author: Aiven

AivenOfficial

Lets agents browse Aiven projects and work with the PostgreSQL, Apache Kafka, ClickHouse and OpenSearch services running in them.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add aiven --env AIVEN_TOKEN='<AIVEN_TOKEN>' --env AIVEN_BASE_URL='<AIVEN_BASE_URL>' -- npx -y mcp-aiven

~/.codex/config.toml

[mcp_servers.aiven]
command = "npx"
args = ["-y", "mcp-aiven"]
env = { AIVEN_TOKEN = "<AIVEN_TOKEN>", AIVEN_BASE_URL = "<AIVEN_BASE_URL>" }

# codex mcp add aiven --env AIVEN_TOKEN='<AIVEN_TOKEN>' --env AIVEN_BASE_URL='<AIVEN_BASE_URL>' -- npx -y mcp-aiven

~/.cursor/mcp.json

{
  "mcpServers": {
    "aiven": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "<AIVEN_TOKEN>",
        "AIVEN_BASE_URL": "<AIVEN_BASE_URL>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "aiven": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "<AIVEN_TOKEN>",
        "AIVEN_BASE_URL": "<AIVEN_BASE_URL>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "aiven": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "<AIVEN_TOKEN>",
        "AIVEN_BASE_URL": "<AIVEN_BASE_URL>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "aiven": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "<AIVEN_TOKEN>",
        "AIVEN_BASE_URL": "<AIVEN_BASE_URL>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "aiven": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "<AIVEN_TOKEN>",
        "AIVEN_BASE_URL": "<AIVEN_BASE_URL>"
      }
    }
  }
}

Remote

claude mcp add --transport http aiven 'https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>'

~/.codex/config.toml

[mcp_servers.aiven]
url = "https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>"

# codex mcp add aiven --url 'https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>'

~/.cursor/mcp.json

{
  "mcpServers": {
    "aiven": {
      "url": "https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "aiven": {
      "type": "http",
      "url": "https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "aiven": {
      "httpUrl": "https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "aiven": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "aiven": {
      "url": "https://mcp.aiven.live/mcp?read_only=<READ_ONLY>&services_scope=<SERVICES_SCOPE>&allow_secrets=<ALLOW_SECRETS>"
    }
  }
}

Environment variables

AIVEN_TOKEN
AIVEN_BASE_URL

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related