Agentic Data Plane
beta

rpk ai mcp create

Create an MCP server

Usage

rpk ai mcp create [flags]

Flags

Value Type Description

--description

string

human-readable description of the server.

--enabled

-

whether server is enabled (default true).

-h, --help

-

help for create.

--managed-config

-

rpk ai mcp types managed MCP config JSON. The @type may be the short name from rpk ai mcp types (e.g. '{"@type":"SQLMCP","driver":"sqlite3","dsn":":memory:"}') or the full proto URL. The per-MCP oneof auth carries any credentials (static_key / user_oauth) — specify it inside the JSON.

--name

string

server name (required).

--transport

string

transport: sse, streamable-http (default "sse").

--url

string

server URL (for remote backend).

--user-oauth-provider

string

for --url (remote) servers: name of the OAuthProvider whose per-user tokens should authenticate upstream requests. Ignored for managed servers — set auth.user_oauth inside --managed-config instead.

--user-oauth-scopes

strings

minimum OAuth scopes a user’s connection must have (user_oauth.required_scopes). Applies only when --user-oauth-provider is set.

-o, --format

string

output format: table|wide|json|yaml|markdown (env: RPAI_FORMAT) (default "table").

--no-color

-

disable colored output (env: NO_COLOR).

-c, --rpai-config

string

path to rpai config (env: RPAI_CONFIG) (default "/var/lib/redpanda/.rpai/config").

-s, --rpai-endpoint

string

override the selected environment’s AI Gateway URL for this invocation.

-p, --rpai-profile

string

rpai profile name (env: RPAI_PROFILE).

-v, --rpai-verbose

-

verbose debug logging to stderr (env: RPAI_VERBOSE).

--token

string

static bearer token override (ambient RPAI_TOKEN is ignored under rpk ai).