SCscalekit
Tool Calling

List tools

Changed on

Workspace catalog. Fetch tools by provider, identifier, and connector. Use this when you need every tool in the environment, not tools bound to one user. If filter.summary is true, returns only tool names.

get/api/v1/tools

Request

Query parameters

filter.summaryboolean

Return only tool names instead of full tool details

filter.providerstring

Filter by tool provider

filter.identifierstring

Filter by connected account identifier

filter.tool_namestring[]

Filter by one or more tool names

filter.querystring

Full-text search query to match tools by name or description (e.g., "gmail get attachment")

filter.connectorstring

Connector name (e.g., 'My Gmail'). When set together with filter.identifier, resolves to a specific connected account and includes its custom MCP tools in the response.

filter.organization_idstring

Organization ID to scope the connected account lookup

filter.user_idstring

User ID to scope the connected account lookup

filter.connected_account_idstring

Connected account ID. Alternative to filter.identifier + filter.connector for directly identifying the connected account whose custom MCP tools should be included.

page_sizeinteger

Maximum number of tools to return per page

page_tokenstring

Token from a previous response for pagination

Response

Paginated list of tools matching the filter

next_page_tokenstring

Token for fetching the next page of tools

prev_page_tokenstring

Token for fetching the previous page of tools

tool_namesstring[]

List of tool names, returned when filter.summary is true

total_sizeinteger

Total number of tools matching the query

Example response

{
  "next_page_token": "eyJwYWdlIjozLCJsaW1pdCI6MzB9",
  "prev_page_token": "eyJwYWdlIjoxLCJsaW1pdCI6MzB9",
  "tool_names": [
    "gmail_send_message"
  ],
  "tools": [
    {
      "definition": {
        "input": {
          "type": "object"
        }
      },
      "id": "tol_123",
      "is_default": true,
      "metadata": {
        "category": "email"
      },
      "provider": "GOOGLE",
      "tags": [
        "notification",
        "email"
      ],
      "updated_at": "2023-10-01T12:00:00Z"
    }
  ],
  "total_size": 104
}

Changes