Tool calling

scalekit.tools returns raw tool schemas so you can build custom agent adapters instead of using scalekit.actions.executeTool directly.

Use this client when you need tool definitions (name, parameters, connector) for frameworks or your own executor. For connect + execute flows, prefer Connected accounts. These methods throw on 4xx/5xx. See Error handling.

Pick a list method:

• listTools — workspace catalog
• listScopedTools — tools already bound to one identifier (the list you pass to an LLM)
• listAvailableTools — tools you can make available for that identifier

listTools

classToolsClienthttps://github.com/scalekit-inc/scalekit-sdk-node/blob/main/src/tools.ts

#asynclistTools

Lists the workspace catalog. Use this when you need every tool in the environment, not tools bound to one user.

paramoptionsobject

Optional fields: filter, pageSize, pageToken.

filter, pageSize, pageToken

returnsListToolsResponse

Paginated tools.

const res = await scalekit.tools.listTools({
  pageSize: 50,
  filter: { query: 'send message' },
});

listScopedTools

classToolsClienthttps://github.com/scalekit-inc/scalekit-sdk-node/blob/main/src/tools.ts

#asynclistScopedTools

Lists tools already bound to one identifier. Use this when you need the list a user is authorized to call.

paramidentifierstring

Connected account identifier to scope the tools list.

paramoptionsobject

Required: filter. Optional: pageSize, pageToken. connectionNames is the Connection name from the dashboard, not a provider slug.

filter, pageSize, pageToken

returnsListScopedToolsResponse

Paginated results.

const res = await scalekit.tools.listScopedTools('user@example.com', {
  filter: {
    connectionNames: ['github-connect'],
  },
  pageSize: 50,
});

listAvailableTools

classToolsClienthttps://github.com/scalekit-inc/scalekit-sdk-node/blob/main/src/tools.ts

#asynclistAvailableTools

Lists tools that can be made available for one identifier. Use this instead of listScopedTools when you need the candidate set, not the tools already bound.

paramidentifierstring

Connected account identifier to list available tools for.

paramoptionsobject

Optional fields: pageSize, pageToken.

pageSize, pageToken

returnsListAvailableToolsResponse

Paginated results.

const res = await scalekit.tools.listAvailableTools('user@example.com', {
  pageSize: 50,
});

executeTool

classToolsClienthttps://github.com/scalekit-inc/scalekit-sdk-node/blob/main/src/tools.ts

#asyncexecuteTool

Executes a tool using credentials from a connected account.

paramparamsobject

Tool execution options.

toolName, identifier, params, connectedAccountId, connector, organizationId, userId

returnsExecuteToolResponse

Tool result and execution ID.

// Low-level tools client (params, not toolInput)
await scalekit.tools.executeTool({
  toolName: 'gmail_fetch_mails',
  identifier: 'user@example.com',
  params: { query: 'is:unread', max_results: 5 },
});

Note: Need a tool Scalekit doesn’t provide? See Build custom tools to proxy any provider API through a connected account.