List tools
Lists the tools in your environment, filtered by connection, provider, tool name or a text query. Use it for every tool in the environment; for the tools one user can call, use List a user's scoped tools. With filter.summary set to true, the response has only tool_names.
Authorization
Authorization: Bearer $TOKEN, an access token from the client credentials grant. See Authentication.
Query parameters
filter.connected_account_idstringConnected account ID. Alternative to filter.identifier + filter.connector for directly identifying the connected account whose custom MCP tools should be included.
filter.connectorstringThe connection name, as shown in AgentKit > Connections.
filter.identifierstringYour app's ID for the user, the same value you used when the user connected. Use a stable internal ID, not an email address.
filter.organization_idstringOrganization ID to scope the connected account lookup
filter.providerstringThe app, such as
GMAIL.filter.querystringFull-text search query to match tools by name or description (e.g., "gmail get attachment")
filter.summarybooleanReturn only tool names instead of full tool details
filter.tool_namearray of stringFilter by one or more tool names
filter.user_idstringUser ID to scope the connected account lookup
page_sizeintegerMaximum number of tools to return per page
page_tokenstringToken from a previous response for pagination
scalekit_client.actions.list_tools
Lists the tools in your environment. Pass connection_name and identifier, or connected_account_id, to include the custom MCP tools of that connected account.
scalekit_client.actions.list_tools( connection_name: Optional[str] = None, identifier: Optional[str] = None, provider: Optional[str] = None, tool_name: Optional[List[str]] = None, query: Optional[str] = None, organization_id: Optional[str] = None, user_id: Optional[str] = None, connected_account_id: Optional[str] = None, summary: Optional[bool] = None, page_size: Optional[int] = None, page_token: Optional[str] = None,) -> ListToolsResponseParameters
connection_nameOptional[str]The connection name, as shown in AgentKit > Connections.
identifierOptional[str]Your app's ID for the user, the same value you used when the user connected. Use a stable internal ID, not an email address.
providerOptional[str]The app, such as
GMAIL.tool_nameOptional[List[str]]Filter to specific tool names
queryOptional[str]Free-form search query across tool metadata
organization_idOptional[str]Organization ID to scope the connected-account lookup
user_idOptional[str]User ID to scope the connected-account lookup
connected_account_idOptional[str]Direct connected account ID, as an alternative to identifier + connection_name
summaryOptional[bool]Set to
True to return only tool names, in tool_names.page_sizeOptional[int]Maximum number of tools to return per page
page_tokenOptional[str]Token from a previous response for pagination
Returns ListToolsResponse: A page of tools, or of tool names with summary.
From scalekit-sdk-python 2.19.1.
scalekit.actions.listTools
Lists the tools in your environment. Pass connectionName and identifier, or connectedAccountId, to include the custom MCP tools of that connected account.
scalekit.actions.listTools( params?: { connectionName?: string; identifier?: string; provider?: string; toolName?: string[]; query?: string; organizationId?: string; userId?: string; connectedAccountId?: string; summary?: boolean; pageSize?: number; pageToken?: string; },): Promise<ListToolsResult>Parameters
connectionNamestringThe connection name, as shown in AgentKit > Connections.
identifierstringYour app's ID for the user, the same value you used when the user connected. Use a stable internal ID, not an email address.
providerstringThe app, such as
GMAIL.toolNamestring[]Filter by one or more tool names
querystringFull-text search query to match tools by name or description (e.g., "gmail get attachment")
organizationIdstringOrganization ID to scope the connected account lookup
userIdstringUser ID to scope the connected account lookup
connectedAccountIdstringConnected account ID. Alternative to filter.identifier + filter.connector for directly identifying the connected account whose custom MCP tools should be included.
summarybooleanSet to
true to return only tool names, in toolNames.pageSizenumberMaximum number of tools to return per page
pageTokenstringToken from a previous response for pagination
Returns Promise<ListToolsResult>.
From @scalekit-sdk/node 2.18.0.
Response 200
next_page_tokenstringToken for fetching the next page of tools
prev_page_tokenstringToken for fetching the previous page of tools
tool_namesarray of stringList of tool names, returned when filter.summary is true
toolsarray of objectList of tools, returned when filter.summary is false or omitted
Show 7 child attributes
definitionobjectTool definition in structured format
idstringUnique ID of the tool. Immutable and read-only.
is_defaultbooleanMarks this tool as the default version for the combination. Read-only.
metadataobjectAdditional metadata about the tool
providerstringProvider name (e.g. GOOGLE). Read-only.
tagsarray of stringTags for categorization or filtering
updated_atstringTimestamp when the tool was last updated. Read-only.
total_sizeintegerTotal number of tools matching the query
Errors
Every error has the same body: code, message and details. See Errors and rate limits.
400Invalid request - malformed filter or pagination parameters401Authentication required - missing or invalid access token