Sign in

v2

latestOpenAPI 3.0.02026-08-051996591.2 MB
Tool Servers

Update tool server

Updates the configuration of a tool server.

patch/v2/tool_servers/{tool_server_id}

Path parameters

tool_server_idstring required
Example:tsr_rag_search

The unique identifier of the tool server to update.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Request body

namestring

The human-readable name of a tool server.

descriptionstring

A detailed description of what this tool server does.

uristring uri

The URI of the tool server.

headersobject

Optional HTTP headers to include when connecting to the server.

transport'sse' | 'streamable-http'

Transport protocol for MCP server connections. Both use Server-Sent Events (SSE).

enabledboolean

Whether the tool server is currently enabled and available for use.

metadataobject

Arbitrary metadata associated with the tool server.

Example request

{
  "name": "RAG Search Server",
  "description": "Provides Vectara specific functionalities.",
  "uri": "https://api.example.com/vectara_mcp/sse/",
  "transport": "sse",
  "auth": {
    "type": "bearer",
    "token": "abcdef......"
  }
}

Response

The updated tool server details.

idstring

Unique identifier for a tool server.

namestring required

The human-readable name of a tool server.

type'mcp' required

The type of tool server.

descriptionstring

A detailed description of what this tool server does.

uristring uri required

The URI of the server.

headersobject

Optional HTTP headers to include when connecting to the server.

transport'sse' | 'streamable-http' required

Transport protocol for MCP server connections. Both use Server-Sent Events (SSE).

enabledboolean required

Whether the tool server is currently enabled and available for use.

metadataobject

Arbitrary metadata associated with the tool server.

created_atstring date-time

Timestamp when the tool server was created.

updated_atstring date-time

Timestamp when the tool server was last updated.

Example response

{
  "id": "tsr_rag_search",
  "name": "RAG Search Server",
  "type": "mcp",
  "description": "Provides RAG search capabilities for documents.",
  "uri": "https://api.example.com/sse/",
  "headers": {
    "Content-Type": "application/json"
  },
  "transport": "sse",
  "metadata": {
    "version": "1.0"
  }
}