Tool Management

await client.fetchTools({
  bot_id: 'bot-id',
  page: 1,            // Optional
  per_page: 10,       // Optional
  filter: { type: 'mcp' }   // Optional: serialised as a JSON query parameter
});

await client.createTool({
  bot_id: 'bot-id',
  name: 'Order lookup',
  description: 'Look up an order by its reference',
  type: 'mcp',
  config: {
    server_id: 'mcp-server-id'
  }
});

await client.fetchTool({ bot_id: 'bot-id', tool_id: 'tool-id' });

await client.updateTool({
  bot_id: 'bot-id',
  tool_id: 'tool-id',
  name: 'Order lookup (v2)',
  description: 'Look up an order by reference or email',
  config: { server_id: 'mcp-server-id' }
});

await client.deleteTool({ bot_id: 'bot-id', tool_id: 'tool-id' });

await client.configureTools({
  bot_id: 'bot-id',
  tool_id: 'tool-id',
  settings: {
    require_approval: 'never'
  }
});

await client.toggleTool({
  bot_id: 'bot-id',
  tool_id: 'tool-id',
  tool_name: 'create_refund',
  active: false
});

await client.refreshTools({ bot_id: 'bot-id', tool_id: 'tool-id' });

const { err, response } = await client.testToolConnection({
  bot_id: 'bot-id',
  tool_id: 'tool-id'
});

if (err) {
  console.error('Tool is unreachable:', err.message);
}