# How MCP Servers Work

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [agentic-data-plane-full.txt](https://docs.redpanda.com/agentic-data-plane-full.txt)

---
title: How MCP Servers Work
latest-operator-version: v26.1.5
latest-console-tag: v3.7.4
latest-connect-version: 4.96.1
latest-redpanda-tag: v26.1.10
docname: mcp-overview
page-component-name: agentic-data-plane
page-version: master
page-component-version: master
page-component-title: Agentic Data Plane
page-relative-src-path: mcp-overview.adoc
page-edit-url: https://github.com/redpanda-data/adp-docs/edit/main/modules/connect/pages/mcp-overview.adoc
description: Connect AI agents to your databases, APIs, and business systems through managed MCP servers Redpanda hosts for you, or self-managed servers you register with ADP.
page-topic-type: overview
personas: agent_builder, platform_engineer
learning-objective-1: Explain how AI agents connect to tools through MCP servers in ADP
learning-objective-2: Distinguish managed from self-managed MCP server backends and choose the right type for your use case
learning-objective-3: Identify key MCP capabilities including tool discovery, authentication, and code mode
page-git-created-date: "2026-05-28"
page-git-modified-date: "2026-06-10"
---

<!-- Source: https://docs.redpanda.com/agentic-data-plane/connect/mcp-overview.md -->

The Model Context Protocol (MCP) is how AI agents talk to tools. In the Agentic Data Plane, you create **MCP Servers** that agents can connect to. Each MCP server exposes a set of [tools](https://docs.redpanda.com/agentic-data-plane/reference/glossary/#tool), [resources](https://docs.redpanda.com/agentic-data-plane/reference/glossary/#resource), and [prompts](https://docs.redpanda.com/agentic-data-plane/reference/glossary/#prompt) that an agent can discover at runtime through `tools/list` and invoke through structured JSON-RPC calls. Redpanda handles upstream credentials, authentication flows, observability, and aggregation, so you can focus on what your agents do, not on the plumbing.

After reading this page, you will be able to:

-   Explain how AI agents connect to tools through MCP servers in ADP

-   Distinguish managed from self-managed MCP server backends and choose the right type for your use case

-   Identify key MCP capabilities including tool discovery, authentication, and code mode


Redpanda offers two kinds of MCP server backends:

| Backend | When to use |
| --- | --- |
| Managed | Redpanda hosts the server in-process. You pick a type from the marketplace (SQL, Kafka, Slack, Jira, OpenAPI, and many more) and configure it with your credentials. No infrastructure to run. |
| Self-managed | You already run an MCP server somewhere and want Redpanda to proxy it for authentication, observability, aggregation, and agent access. Redpanda fronts your server with a managed URL and resolves authentication at the gateway. |

The default catalog covers databases, cloud and productivity services, streaming systems, and communication tools. See [Managed catalog](https://docs.redpanda.com/agentic-data-plane/connect/managed/managed-catalog/) for the full list.

## [](#when-to-use-each)When to use each

| Concern | Managed | Self-managed |
| --- | --- | --- |
| Infrastructure ownership | Redpanda hosts and operates | You host and operate |
| Upstream credentials | Redpanda secret store; per-type schema | Redpanda secret store or token vault; you control the upstream authentication |
| Custom tool logic | Limited to what the type exposes | Anything the MCP protocol supports |
| Startup latency | In-process; effectively zero | Network round-trip to your endpoint |
| Upgrade cadence | Redpanda manages | You manage |

## [](#whats-in-redpanda-adp)What’s in Redpanda ADP

ADP has these top-level areas:

-   **LLM Providers**: OpenAI, Anthropic, Bedrock, Google AI, OpenAI-compatible endpoints. See [Configure your LLM provider](https://docs.redpanda.com/agentic-data-plane/gateway/configure-provider/).

-   **MCP Servers**: You are here. Both managed and self-managed servers live in this list.

-   **OAuth Providers**: Reusable upstream OAuth provider definitions used by user-delegated MCP authentication. See [Configure an OAuth Provider](https://docs.redpanda.com/agentic-data-plane/connect/oauth-providers/).

-   **OAuth Clients**: External tools registered to request access tokens from the gateway. See [Connect Remote MCP Clients](https://docs.redpanda.com/agentic-data-plane/connect/remote-mcp-clients/).

-   **Connections**: Per-user OAuth connections for user-delegated MCP servers. See [User-delegated OAuth](https://docs.redpanda.com/agentic-data-plane/connect/user-delegated-oauth/).


## [](#key-capabilities)Key capabilities

-   **Tool discovery**: After you create or register a server, Redpanda performs a live `tools/list` against it and populates the server’s detail page so you can see which tools are visible to agents.

-   **Service-account and user-delegated authentication**: Pick a single shared upstream identity for all callers, or have each end-user authenticate against the upstream system with their own credentials.

-   **Code mode**: For a server with a large tool catalog, turn on code mode to expose just two tools, `search` and `execute`, so an agent can find tools by regex and run them through a JavaScript sandbox instead of loading every tool definition into its context. See [Code Mode](https://docs.redpanda.com/agentic-data-plane/gateway/code-mode/).

-   **Inspector**: Test each tool, resource, and prompt directly from ADP before pointing an agent at the server. See [Test a server’s tools](https://docs.redpanda.com/agentic-data-plane/connect/test-tools/).


## [](#next-steps)Next steps

-   [Create an MCP Server](https://docs.redpanda.com/agentic-data-plane/connect/create-server/)

-   [Register a Self-Managed MCP Server](https://docs.redpanda.com/agentic-data-plane/connect/register-remote/)

-   [Plug in an App, Database, or Tool](https://docs.redpanda.com/agentic-data-plane/connect/managed/managed-catalog/)