Tool Management APIs

The Tool Management APIs handle individual tools available to agents, including both built-in tools and those discovered from MCP tool servers.

• List available tools that agents can use
• Get tool details including parameters, descriptions, and capabilities
• Update tool settings for MCP tools
• Delete tools when no longer needed
• Manage tool configurations with full versioning support

Tool types

• Web search tools: Internet search via Tavily provider
• Corpora search tools: Query Vectara corpora for relevant content
• MCP tools: External tools discovered from tool servers

Tool properties

• Name and description: Human-readable identification
• Parameters: Input schema defining what data the tool accepts
• Capabilities: What actions the tool can perform
• Access control: Which agents or users can use the tool

Available endpoints

Endpoint	Method	Purpose
List Tools	GET	Retrieve all available tools
Get Tool	GET	Get detailed configuration of a specific tool
Update Tool	PATCH	Modify tool settings or parameters
Delete Tool	DELETE	Remove a custom tool

Built-in tools

Web Search

WEB SEARCH

Code example with json syntax.json

1

Corpora Search

CORPORA SEARCH

Code example with json syntax.json

1

MCP Tools

MCP TOOLS

Code example with json syntax.json

1