Tools SDK - Runtools.ai

rt.tools is the runtime side of the Tool Hub — discover tools, install them, manage credentials, and execute actions, all with the caller’s auth. To build a tool, see Custom Tools.

Marketplace

const marketplace = await rt.tools.marketplace();
const github = await rt.tools.get('github');
const matches = await rt.tools.search('email');

Installed Tools

await rt.tools.install('github');

const installed = await rt.tools.list();

await rt.tools.uninstall('github');

Admins can pass { all: true } to list() and custom() for broader org views.

Credentials

await rt.tools.storeCredentials('my-api-tool', {
  apiKey: process.env.MY_API_KEY!,
});

const status = await rt.tools.credentials('my-api-tool');

await rt.tools.clearCredentials('my-api-tool');

OAuth tools should normally use Connected Apps instead of stored manual credentials. If more than one account is connected for a provider, execution uses your default account unless you pass oauth.account or oauth.connectionId:

await rt.tools.execute('gmail', {
  action: 'list_emails',
  params: { query: 'from:hello@example.com' },
  oauth: {
    account: 'artkara2002@gmail.com',
  },
});

Execute

const result = await rt.tools.execute('github', {
  action: 'list_repos',
  params: {},
});

if (result.success) {
  console.log(result.result);
} else {
  console.error(result.error?.message);
}

Use credentialOverrides to map a tool credential field to a named secret:

await rt.tools.execute('my-api-tool', {
  action: 'lookup',
  params: { id: 'cus_123' },
  credentialOverrides: {
    apiKey: 'CUSTOMER_API_KEY',
  },
});

Custom Tools

const customTools = await rt.tools.custom();
await rt.tools.setVisibility('customer-api', 'org');

Build custom tools with defineTool() and deploy them with the CLI. See Custom Tools.

Methods

Method	Description
`marketplace({ category? })`	List public marketplace tools
`search(query)`	Search public tools
`get(slug)`	Get marketplace metadata
`list({ all? })`	List installed tools
`custom({ all? })`	List visible custom tools
`install(slug)`	Install a tool
`uninstall(slug)`	Uninstall a tool
`forceUninstall(slug)`	Admin-only removal across the org
`setVisibility(slug, visibility)`	Set custom tool visibility
`storeCredentials(slug, credentials)`	Store manual credentials
`credentials(slug)`	Check credential status
`clearCredentials(slug)`	Clear manual credentials
`execute(slug, options)`	Run a tool action
`schemas()`	Prefetch JSON schemas for marketplace tools
`activity(slug, options?)`	Read a tool’s execution activity (`{ limit?, cursor? }`)

​Marketplace

​Installed Tools

​Credentials

​Execute

​Custom Tools

​Methods