# aiven-mcp

Create and manage Aiven services from AI assistants such as Cursor and Claude Code.

MCP server by Aiven. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx add-mcp mcp-aiven --env 'AIVEN_TOKEN=${AIVEN_TOKEN}'
```

Works with: Claude Code, Codex CLI, Cursor, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx add-mcp mcp-aiven --env 'AIVEN_TOKEN=${AIVEN_TOKEN}' -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Where it runs

Your computer.

## What it needs

Environment variables:

- `AIVEN_TOKEN` (required): Your Aiven API token.
- `AIVEN_READ_ONLY` (optional): "true" enables read-only mode.
- `AIVEN_ALLOW_SECRETS` (optional): "true" returns PostgreSQL and Kafka connection credentials to the agent.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Needs a key or account: It asks for an API key or a sign in before it works.

## Source

[Open the source](https://aiven.io/docs/tools/mcp). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

- Previous: [aiven](https://syn4pse.dev/terminal/aiven-mcp-remote.md)
- Next: [baseten](https://syn4pse.dev/terminal/baseten-mcp.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
