mcp-confluent: Instructions file for GitHub Copilot

.github/copilot-instructions.md

mcp-confluent copilot-instructions.md is an instructions file for GitHub Copilot from confluentinc/mcp-confluent. It costs 3,607 tokens per session, scanned A, original, MIT.

A Copilot instruction file for an MCP server that exposes Apache Kafka and Confluent tools to AI assistants. Kafka is a system for sending and storing streams of messages; Confluent adds hosted and related services around it.

In plain words
What is it for?
Use it when reviewing or changing the server's Kafka tools, Confluent Cloud integrations, transports, and main code layers.
Why use it?
It gives reviewers project context and points them to the important architecture and data-flow rules.

Instructions file for GitHub Copilot ✓ vendor

Written for GitHub Copilot: a Copilot instructions file. Also seen: mentions CLAUDE.md.

This is confluentinc/mcp-confluent's own configuration. It tells GitHub Copilot how to work on mcp-confluent itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mcp-confluent configures →

About the project

Confluent MCP Server is an open-source Model Context Protocol server that lets AI assistants interact with Confluent Cloud, Confluent Platform, and standalone Apache Kafka through natural language. Its tools cover Kafka, Flink SQL, Schema Registry, connectors, and Tableflow. The catalogue add-ons help agents operate and configure the server.

confluentinc/mcp-confluent · 168 stars · on GitHub

Reuse

Borrowing it

Nothing to install: this file belongs to confluentinc/mcp-confluent. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/confluentinc/mcp-confluent/main/.github/copilot-instructions.md
Clone the repo
git clone --depth 1 https://github.com/confluentinc/mcp-confluent

Made for: GitHub Copilot.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mcp-confluent copilot-instructions.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/confluentinc/mcp-confluent/copilot-instructions/github.svg)](https://agentmods.dev/instructions/confluentinc/mcp-confluent/copilot-instructions)
Your own site
<a href="https://agentmods.dev/instructions/confluentinc/mcp-confluent/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/confluentinc/mcp-confluent/copilot-instructions/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mcp-confluent copilot-instructions.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/confluentinc/mcp-confluent/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/confluentinc/mcp-confluent/copilot-instructions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 3,607 This file is loaded in full into every session.
When invoked 3,607 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.03607 $0.03607
Opus 5.5 $0.01443 $0.01443
Sonnet 5.5 $0.00721 $0.00721
Haiku 4.5 $0.00361 $0.00361

Measured yesterday against content hash c9269b031f5b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mcp-confluent copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/copilot-instructions.md · 240 lines

How it starts

The opening of the file, as written. The whole thing — 240 lines — stays where its author put it; the contents beside it link to each section on GitHub.

mcp-confluent

Project Overview

MCP (Model Context Protocol) server that exposes Kafka-ecosystem and Confluent tooling to AI assistants. The tool surface splits into two groups:

  • Kafka-protocol tools that work against any Apache Kafka®-compatible cluster or Schema Registry (e.g., topic CRUD, producing and consuming messages, schema management).
  • Confluent Cloud-specific tools that wrap CCloud REST APIs (e.g., Flink, Tableflow, billing), enabled only when the relevant service block (confluent_cloud:, flink:, tableflow:) is present in a connection's resolved config (from YAML or, during the migration, legacy env vars + CLI args).

Built with TypeScript, Node.js ≥22.23.4, and the @modelcontextprotocol/sdk. Ships as an npm package and a Docker image; supports stdio, Streamable HTTP, and (for backwards compatibility with older MCP clients) the legacy HTTP+SSE transport.

These instructions exist to keep GitHub Copilot PR reviews focused on the invariants that matter in this codebase. Author-facing guidance (how to scaffold a tool, run the inspector, etc.) lives in CONTRIBUTING.md and CLAUDE.md — refer to those rather than repeating them here.

Architecture (what reviewers need to know)

Entry flow

At startup: parseCliArgs() → initEnv() → branch on whether -c <path> was supplied: loadConfigFromYaml(path, process.env) for the YAML path, or buildConfigFromEnvAndCli(env, ...) for the legacy env+CLI path. Both return a single MCPServerConfiguration. Then ServerRuntime.fromConfig() constructs one DirectClientManager per connection → iterates ToolName enum to build the enabled tool set → registers tools on McpServer → starts transports.

YAML (-c <path>) is the preferred path. The env-var-only path is legacy: parity remains for a single connection in this release, but it's slated for a startup warning in a near-future release and removal a release or two later. Don't approve new code that reaches back into the legacy synthesizer or assumes env-only configuration as the canonical model. User-facing version of this story: CONFIGURATION.md at the repo root.

Read the full file on GitHub · 240 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed c9269b031f5b
  2. 1mo ago First seen · 240 lines · 3,607 tokens per session scan A e6ac0c416b63

Subscribe to this mod's changes

mcp-confluent copilot-instructions.md is an instructions file published in the GitHub repository confluentinc/mcp-confluent (168 stars, last pushed yesterday), licensed MIT. It adds 3,607 tokens to every session, about $0.0144 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories