Tools API

    List, manage, and directly execute external tools.

    list()

    typescript
    const { data: tools } = await client.tools.list();

tools.forEach(tool => {
  console.log(`${tool.name} (${tool.type}): ${tool.description}`);
});

    get()

    typescript
    const tool = await client.tools.get('tool-uuid');

console.log(tool.name);
console.log(tool.inputSchema);  // JSON Schema
console.log(tool.outputSchema); // JSON Schema

    executeDirect()

    Execute a tool directly without an agent, useful for testing or one-off operations.

    typescript
    const result = await client.tools.executeDirect('tool-uuid', {
  query: 'latest AI research',
  maxResults: 5,
});

console.log(result.output);

    Tool Types

    TypeDescriptionExample
    apiExternal HTTP API integrationREST endpoints, webhooks
    functionServer-side function executionDatabase queries, computations
    browserBrowser automationWeb scraping, screenshots
    codeSandboxed code executionPython/JS code blocks