Tools

List available tools

Use kirha.tools({ focus }) to list the tools of a vertical. focus is required here:

import { Kirha } from "kirha";

const kirha = new Kirha({ apiKey: process.env.KIRHA_API_KEY });

const tools = await kirha.tools({ focus: "crypto" }); 
for (const tool of tools) { 
  console.log(`${tool.name}: ${tool.description}`); 
} 

Each tool returned by kirha.tools() includes an inputSchema and outputSchema that describe the expected parameters and response shape. Always follow these schemas strictly when calling a tool, as malformed inputs will be rejected.

Each tool execution consumes credits. You can track usage on the Dashboard.

Execute a tool directly

Use kirha.executeTool(toolName, params) to call a specific tool with explicit parameters, bypassing the planning engine:

import { Kirha } from "kirha";

const kirha = new Kirha({ apiKey: process.env.KIRHA_API_KEY });

const result = await kirha.executeTool("coingecko_searchCoin", { 
  query: "avax", 
  limit: 1, 
}); 
console.log(result.output); 

When to use direct tool execution

Use kirha.search() or kirha.plan() when you have a natural language query and want KIRHA to pick the tools. This is the recommended approach for most use cases.

Use kirha.executeTool() when you:

• Already know which tool and parameters you need
• Want to skip the planning step for your own orchestration logic
• Need to call a single provider in isolation

Tools options

Execute tool options