Agentic Data Plane

rpk ai mcp-server tools list

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

The command reaches the server’s /mcp/v1/<name> endpoint, so the same auth path used by tools call is exercised here. Useful for checking that a server’s tool schema loaded correctly and that a user-delegated server is reachable with your stored connection.

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

rpk ai mcp-server tools call <server> search --code-mode
This command was introduced in ai version 0.2.28.

Usage

rpk ai mcp-server tools list [flags]

Flags

Value Type Description

--code-mode

bool

Target the virtual code-mode sibling endpoint (<server>-code) instead of the primary.

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.