Sign in

v4

OpenAPI 3.1.02026-07-313621,3961.8 MB
Agents Platform

Update Mcp Server Configuration

Update the configuration settings for an MCP server.

patch/v1/convai/mcp-servers/{mcp_server_id}

Path parameters

mcp_server_idstring required

ID of the MCP Server.

ID of the MCP Server.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body

approval_policy'auto_approve_all' | 'require_approval_all' | 'require_approval_per_tool'

Defines the MCP server-level approval policy for tool execution.

force_pre_tool_speechboolean nullable

DEPRECATED: use pre_tool_speech instead. If set, overrides the server's force_pre_tool_speech setting for this tool.

pre_tool_speech'auto' | 'force' | 'off'
disable_interruptionsboolean nullable

DEPRECATED: use interruption_mode instead. If set, overrides the server's disable_interruptions setting for this tool.

interruption_mode'allow' | 'disable_during_tool' | 'disable_during_tool_and_turn'
tool_call_sound'typing' | 'elevator1' | 'elevator2' | 'elevator3' | 'elevator4'

Predefined tool call sounds; None means no sound.

tool_call_sound_behavior'auto' | 'always'

Determines how the tool call sound should be played.

execution_mode'immediate' | 'post_tool_speech' | 'async'
response_timeout_secsinteger nullable

The maximum time in seconds to wait for each MCP tool call to complete.

request_headersobject nullable

The headers to include in requests to the MCP server

disable_compressionboolean nullable

Whether to disable HTTP compression for this MCP server

Response

Successful Response

idstring required