v1
protected
agents

Get All Tools

Get all available tools across all types.

Returns a unified list of tools from:

  • Code tools (static, YAML-based)
  • MCP tools (dynamic, from running instances)

Query Parameters: include: Comma-separated tool types (default: "code,mcp") mcp_instance_id: Filter MCP tools by instance (optional)

Example: GET /v1/agents/tools?include=code,mcp GET /v1/agents/tools?include=code GET /v1/agents/tools?include=mcp&mcp_instance_id={uuid}

get/v1/workspaces/{workspace}/agents/tools

Path parameters

workspacestring required

Slug of the workspace the request acts in

Slug of the workspace the request acts in

Query parameters

includestring

Comma-separated list of tool types to include (code, mcp)

Comma-separated list of tool types to include (code, mcp)

mcp_instance_idstring uuid nullable

Filter MCP tools by specific instance ID

Filter MCP tools by specific instance ID

Response

Successful Response

categorystring
descriptionstring required
display_namestring
group'sandbox' nullable
input_schemaobject
mcp_instance_idstring uuid nullable
mcp_instance_namestring nullable
namestring required
plane'runtime' | 'build' | 'operate' | 'observe' | 'govern' | 'federate' nullable
requires_user_confirmationboolean
type'code' | 'mcp' required

Changes