Developer Documentation
ADC CLI Commands
Current Release 13.1 13.0 12.1

mcpProfile

July 17, 2026
Contributed by: 
C

The following operations can be performed on “mcpProfile”:

add set unset rm show rename

add mcpProfile

Creates a mcp profile that can be attached to service of type HTTP/SSL.

Synopsis

add mcpProfile \[-proxyMode \( FORWARD | REVERSE )] \[-profileType \( BACKEND | FRONTEND )] \[-hostReplacement \( ENABLED | DISABLED )] \[-urlReplacement \( ENABLED | DISABLED )] \[-protocolVersion ] \[-tokenOrApi ] \[-comment ] \[-insertHeaderInClientRequest \( ENABLED | DISABLED )]

Arguments

name Name for the mcp profile. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) hash (#), space ( ), at (@), equals (=), colon (:), and underscore characters.

The following requirement applies only to the Citrix ADC CLI: If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, “my mcp profile”).

proxyMode Proxy mode for the MCP profile. FORWARD mode replaces Host and URL in backend requests. REVERSE mode passes requests as-is.

Possible values: FORWARD, REVERSE Default value: FORWARD

profileType Type of MCP profile. Frontend profiles apply to the entity that receives requests from a client. Backend profiles apply to the entity that sends client requests to a server.

Possible values: BACKEND, FRONTEND Default value: BACKEND

hostReplacement Whether the Host header should be replaced with the backend MCP server FQDN in FORWARD proxy mode. If mcpProxyMode is FORWARD, this parameter is ENABLED bydefault. If mcpProxyMode is REVERSE, this parameter is DISABLED and cannot be ENABLED.

Possible values: ENABLED, DISABLED

urlReplacement Whether the URL should be replaced with the backend MCP server URL in FORWARD proxy mode. If mcpProxyMode is FORWARD, this parameter is ENABLED bydefault. If mcpProxyMode is REVERSE, this parameter is DISABLED and cannot be ENABLED.

Possible values: ENABLED, DISABLED

protocolVersion MCP protocol version to advertise during monitoring of a mcp server. Default value: NS_S_MCP_PROTOCOL_VERSION

tokenOrApi If you like to insert Bearer or API token, configure this parameter with full header.

comment Any information about the MCP profile.

insertHeaderInClientRequest Whether mcp_token_or_api configuration will be used for MCP requests coming from client.

Possible values: ENABLED, DISABLED Default value: DISABLED

Example

add mcpProfile my_mcp -mcpProtocolVersion 2025-11-25 -mcpHttpHeader “Authorization: Bearer XYZ”

set mcpProfile

Modifies the specified parameter of MCP profile.

Synopsis

set mcpProfile \[-proxyMode \( FORWARD | REVERSE )] \[-hostReplacement \( ENABLED | DISABLED )] \[-urlReplacement \( ENABLED | DISABLED )] \[-protocolVersion ] \[-tokenOrApi ] \[-comment ] \[-insertHeaderInClientRequest \( ENABLED | DISABLED )]

Arguments

name Name for the mcp profile. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) hash (#), space ( ), at (@), equals (=), colon (:), and underscore characters.

The following requirement applies only to the Citrix ADC CLI: If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, “my mcp profile”).

proxyMode Proxy mode for the MCP profile. FORWARD mode replaces Host and URL in backend requests. REVERSE mode passes requests as-is.

Possible values: FORWARD, REVERSE Default value: FORWARD

hostReplacement Whether the Host header should be replaced with the backend MCP server FQDN in FORWARD proxy mode. If mcpProxyMode is FORWARD, this parameter is ENABLED bydefault. If mcpProxyMode is REVERSE, this parameter is DISABLED and cannot be ENABLED.

Possible values: ENABLED, DISABLED

urlReplacement Whether the URL should be replaced with the backend MCP server URL in FORWARD proxy mode. If mcpProxyMode is FORWARD, this parameter is ENABLED bydefault. If mcpProxyMode is REVERSE, this parameter is DISABLED and cannot be ENABLED.

Possible values: ENABLED, DISABLED

protocolVersion MCP protocol version to advertise during monitoring of a mcp server. Default value: NS_S_MCP_PROTOCOL_VERSION

tokenOrApi If you like to insert Bearer or API token, configure this parameter with full header.

comment Any information about the MCP profile.

insertHeaderInClientRequest Whether mcp_token_or_api configuration will be used for MCP requests coming from client.

Possible values: ENABLED, DISABLED Default value: DISABLED

Example

set mcpProfile my_mcp -mcpProtocolVersion 2025-06-18

unset mcpProfile

Use this command to remove mcpProfile settings.Refer to the set mcpProfile command for meanings of the arguments.

Synopsis

unset mcpProfile [-proxyMode] [-hostReplacement] [-urlReplacement] [-protocolVersion] [-tokenOrApi] [-comment] [-insertHeaderInClientRequest]

rm mcpProfile

Deletes a MCP profile.

Synopsis

rm mcpProfile

Arguments

name Name for the mcp profile. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) hash (#), space ( ), at (@), equals (=), colon (:), and underscore characters.

The following requirement applies only to the Citrix ADC CLI: If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, “my mcp profile”).

Example

rm mcpProfile my_mcp

show mcpProfile

Displays the current settings for the specified mcpProfile. If no profile name is provided, displays a list of all mcpProfiles currently configured on the Citrix ADC.

Synopsis

show mcpProfile []

Arguments

name Name for the mcp profile. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) hash (#), space ( ), at (@), equals (=), colon (:), and underscore characters.

The following requirement applies only to the Citrix ADC CLI: If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, “my mcp profile”).

Output

proxyMode Proxy mode for the MCP profile. FORWARD mode replaces Host and URL in backend requests. REVERSE mode passes requests as-is.

profileType Type of MCP profile. Frontend profiles apply to the entity that receives requests from a client. Backend profiles apply to the entity that sends client requests to a server.

hostReplacement Whether the Host header should be replaced with the backend MCP server FQDN in FORWARD proxy mode. If mcpProxyMode is FORWARD, this parameter is ENABLED bydefault. If mcpProxyMode is REVERSE, this parameter is DISABLED and cannot be ENABLED.

urlReplacement Whether the URL should be replaced with the backend MCP server URL in FORWARD proxy mode. If mcpProxyMode is FORWARD, this parameter is ENABLED bydefault. If mcpProxyMode is REVERSE, this parameter is DISABLED and cannot be ENABLED.

protocolVersion MCP protocol version to advertise during monitoring of a mcp server.

tokenOrApi If you like to insert Bearer or API token, configure this parameter with full header.

comment Any information about the MCP profile.

insertHeaderInClientRequest Whether mcp_token_or_api configuration will be used for MCP requests coming from client.

devno count stateflag _nextgenAPIResource

Example

show mcpProfile my_mcp

rename mcpProfile

Renames a mcpProfile.

Synopsis

rename mcpProfile @ @

Arguments

name Existing name of the mcpProfile to be renamed.

newName New name for the mcpProfile. Must begin with an ASCII alphabetic or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@), equals (=), and hyphen (-) characters.

Example

rename mcpProfile prof1 prof2

mcpProfile
July 17, 2026
Contributed by: 
C
July 17, 2026
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.