# rpk ai mcp-server tools list

> 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: rpk ai mcp-server tools list
latest-operator-version: v26.2.1
latest-console-tag: v3.10.0
latest-connect-version: 4.105.0
latest-redpanda-tag: v26.2.1
docname: rpk/rpk-ai/rpk-ai-mcp-server-tools-list
page-component-name: agentic-data-plane
page-version: master
page-component-version: master
page-component-title: Agentic Data Plane
page-relative-src-path: rpk/rpk-ai/rpk-ai-mcp-server-tools-list.adoc
page-edit-url: https://github.com/redpanda-data/adp-docs/edit/main/modules/reference/pages/rpk/rpk-ai/rpk-ai-mcp-server-tools-list.adoc
description: List tools on an MCP server by calling tools/list through the aigw MCP proxy. Hits the server's /mcp/v1/<name> endpoint, so the same auth and token-vault path used by tools/call is exercised here.
page-git-created-date: "2026-07-28"
page-git-modified-date: "2026-08-06"
---

<!-- Source: https://docs.redpanda.com/agentic-data-plane/reference/rpk/rpk-ai/rpk-ai-mcp-server-tools-list.md -->

List tools on an MCP server by calling tools/list through the aigw MCP proxy.

Hits the server’s /mcp/v1/<name> endpoint, so the same auth and token-vault path used by tools/call is exercised here. Useful for checking that a managed MCP’s tool schema loaded correctly and that a user-delegated server is reachable with the caller’s vault token.

With `--code-mode` the session targets the virtual code-mode sibling endpoint (/mcp/v1/<name>-code), which exposes the sandbox meta-tools (`search`, execute). To see the parent’s tool catalog from the sandbox, invoke the search tool explicitly:

```text
rpk ai mcp tools call <server> search --code-mode
```

> 📝 **NOTE**
>
> This command was introduced in ai version 0.2.28.

## [](#usage)Usage

```bash
rpk ai mcp-server tools list [flags]
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --code-mode | bool | Target the virtual code-mode sibling endpoint (<server>-code) instead of the primary. |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |