Confluent (Kafka) MCP Server
Official Confluent MCP server with 50+ tools for managing Kafka topics, Flink SQL, Schema Registry, Connectors, and Tableflow via natural language.
The Confluent MCP server is an official open-source Model Context Protocol server maintained by Confluent that lets AI assistants interact with Confluent Cloud, Confluent Platform, and Apache Kafka deployments through natural language. It exposes more than 50 tools spanning Kafka topic and message operations, Flink SQL statement management, Schema Registry, Connectors, Tableflow, metrics and billing queries, tags, and catalog search.
The server supports three transport mechanisms (stdio, HTTP, and SSE) and two authentication modes: static API keys configured in a YAML file, or OAuth (PKCE) browser-based sign-in via Confluent Cloud for supported tool categories. It also includes always-available documentation tools (search-product-docs, get-product-doc-page) and diagnostics (explain-disabled-tools) so agents can discover which capabilities are usable in the current configuration.
Because it is maintained by Confluent itself and distributed as the @confluentinc/mcp-confluent npm package, it is the canonical way to plug Kafka and Flink workflows into Claude Desktop, Cursor, VS Code, Goose, Gemini CLI, and Windsurf.
Tools
| Tool | Description |
|---|---|
list-topics |
List Kafka topics in the configured cluster. |
create-topics |
Create one or more Kafka topics with specified configuration. |
produce-message |
Produce a message to a Kafka topic. |
consume-messages |
Consume messages from a Kafka topic. |
create-flink-statement |
Create and submit a Flink SQL statement on Confluent Cloud. |
list-flink-statements |
List Flink SQL statements in the environment. |
list-connectors |
List Kafka Connect connectors. |
create-connector |
Create a new Kafka Connect connector. |
search-product-docs |
Search Confluent product documentation. |
get-product-doc-page |
Retrieve a specific Confluent documentation page. |
explain-disabled-tools |
Diagnose why specific tools are disabled in the current configuration. |
Prerequisites
- Node.js 22 or higher
- A Confluent Cloud account (for cloud features) or a local Kafka/Schema Registry endpoint
- Confluent Cloud API keys, or use OAuth (PKCE) browser sign-in
Install and initialize
# Generate a starter config.yaml
npx @confluentinc/mcp-confluent --init-config
# Edit config.yaml with your bootstrap servers, API keys, endpoints, etc.
# (Optional) Initialize OAuth instead of static keys
npx @confluentinc/mcp-confluent --init-oauth-config
Example minimal config.yaml:
connections:
local:
type: direct
kafka:
bootstrap_servers: "localhost:9092"
schema_registry:
endpoint: "http://localhost:8081"
Claude Desktop config
Add the following to claude_desktop_config.json (paths from the repo's example.claude_desktop_config.json):
{
"mcpServers": {
"confluent": {
"command": "node",
"args": [
"/path/to/confluent-mcp-server/dist/index.js",
"--config",
"/path/to/confluent-mcp-server/config.yaml"
]
}
}
}
You can also run via npx directly:
{
"mcpServers": {
"confluent": {
"command": "npx",
"args": ["-y", "@confluentinc/mcp-confluent", "--config", "/absolute/path/to/config.yaml"]
}
}
}
Transports
The server supports stdio (default), http, and sse. Enable multiple with:
npx @confluentinc/mcp-confluent --transport http,sse,stdio
When exposing HTTP/SSE, set server.auth.api_key in config.yaml and configure server.http.port.
Useful flags
--list-tools: print all tools available for the current configurationDO_NOT_TRACK=true: disable telemetry
- Create, list, and reconfigure Kafka topics across Confluent Cloud or local clusters from a chat interface.
- Produce test messages and consume from topics to validate pipelines without writing client code.
- Author, submit, and inspect Flink SQL statements on Confluent Cloud compute pools.
- Manage Kafka Connect connectors (create, update, list) and troubleshoot Tableflow integrations.
- Search Confluent product documentation and diagnose disabled tools while building agents.
- "List all topics in my Confluent Cloud cluster and show partition counts."
- "Create a new topic called
orders-eventswith 6 partitions and replication factor 3." - "Submit this Flink SQL statement to compute pool
lfcp-prodand report any errors." - "Show me the last 20 messages on
payments.failedand summarize the error codes." - "Find docs explaining how to set up Tableflow with Iceberg catalogs."
- Officially maintained by Confluent and published to npm as
@confluentinc/mcp-confluent. - Broad coverage: 50+ tools across Kafka, Flink SQL, Schema Registry, Connectors, and Tableflow.
- Supports multiple transports (stdio, HTTP, SSE) and both static API keys and OAuth (PKCE).
- Works with Claude Desktop, Claude Code, Cursor, VS Code, Goose, Gemini CLI, and Windsurf.
- Requires Node.js 22+ and a YAML configuration step before first use.
- Some tool categories still require static API keys; OAuth coverage is partial and migration is ongoing.
- Tableflow operations require prerequisite IAM role setup in Confluent Cloud.
- kafka-mcp-server (community) community implementations targeting plain Apache Kafka clusters without Confluent Cloud features.
- Direct use of the Confluent CLI (
confluent) wrapped via a generic shell MCP server for users who prefer CLI semantics. - Redpanda's own tooling for teams running Redpanda instead of Confluent/Kafka.