Skip to main content

Toolkits

Tags: ai, tools

Available AI toolkits and capabilities

Endpoints​

List​

GET /api/v2/w/{workspace_uuid}/toolkits

Also mounted at: GET /api/v2/w/{workspace_uuid}/toolkits/

Description:

List all available toolkits for the workspace based on enabled features.

Toolkits group related tools together and are returned in MCP (Model Context Protocol) format. Each toolkit contains:

  • name: unique identifier (e.g., "base", "browser", "data")
  • displayName: human-readable name
  • description: optional description of the toolkit's purpose
  • tools: list of tools in the toolkit
  • connection: present on MCP-server toolkits (GRA-6279) — connection metadata for the tool selector: serverId, state, enabled, connected (workspace-level: enabled + ready; gates selection), memberConnected (current member has a usable credential), authType (oauth | direct_auth), authorizeUrl (relative API path for the OAuth popup), and toolsListed (false when the tool list could not be fetched). null for builtin/custom/app-connection toolkits.

Each tool name follows the format: \{toolkit_name}:\{tool_slug}.

ALL workspace MCP servers are listed — including unconnected ones — so the selector can render every source with an inline connect affordance. Connected MCP servers may refresh OAuth tokens and fetch tool definitions from the remote server when listing toolkits.

Authorization: Requires agents:read scope

Response: See ToolkitsResponse

List​

GET /api/v2/w/{workspace_uuid}/toolkits

Also mounted at: GET /api/v2/w/{workspace_uuid}/toolkits/

Description:

List all available toolkits for the workspace based on enabled features.

Toolkits group related tools together and are returned in MCP (Model Context Protocol) format. Each toolkit contains:

  • name: unique identifier (e.g., "base", "browser", "data")
  • displayName: human-readable name
  • description: optional description of the toolkit's purpose
  • tools: list of tools in the toolkit
  • connection: present on MCP-server toolkits (GRA-6279) — connection metadata for the tool selector: serverId, state, enabled, connected (workspace-level: enabled + ready; gates selection), memberConnected (current member has a usable credential), authType (oauth | direct_auth), authorizeUrl (relative API path for the OAuth popup), and toolsListed (false when the tool list could not be fetched). null for builtin/custom/app-connection toolkits.

Each tool name follows the format: \{toolkit_name}:\{tool_slug}.

ALL workspace MCP servers are listed — including unconnected ones — so the selector can render every source with an inline connect affordance. Connected MCP servers may refresh OAuth tokens and fetch tool definitions from the remote server when listing toolkits.

Authorization: Requires agents:read scope

Response: See ToolkitsResponse