Create the tool
In the PAL Maker, open Connectors & Tools, choose New Tool → API tool, and paste this into the JSON editor:on_call: generate_fillerhas the PAL say a short line while the search runs.on_resolve: generate_responsehas it answer in its own words from the results.- Without a key, the
X-Keenable-Titleheader is required. Set it to your app’s name. body_templatesends onlyqueryandmax_results. Without it, Tavus also sends the filler line it adds to the arguments.- Five results are enough for a spoken answer. More results give the model more text to read and make the reply slower.
POST /v2/tools.
Attach it to a PAL
Add the tool to your PAL in the PAL Maker, or with the API:internet_search), turn it off, so the PAL uses one search instead of two:
Use an API key
Tavus calls Keenable from its own servers, so without a key every Tavus customer shares the same per-IP limit on the public endpoint. Use a key for anything beyond a demo:- Create a key in the Keenable console.
- In the tool, drop
/publicfrom the URL, remove theX-Keenable-Titleheader, and addauth:
Or connect the MCP server
Tavus MCP connectors also accept the Keenable MCP server, which adds page fetch to search. Registerhttps://api.keenable.ai/mcp-public with auth none, or https://api.keenable.ai/mcp with auth api_key (header X-API-Key), and add the connector to layers.mcp.connectors on the PAL. A connector runs as a background task: the PAL acknowledges the request and reports the result when it lands. For an answer in the same turn, use the API tool above.
Related pages
Pipecat
KeenableWebSearch gives Pipecat voice agents low-latency web search and page fetch.
Search quickstart
Give your agent ranked web pages with excerpts ready to cite. Try it with no API key. Code, cost per mode, filters by site, date and domain, and gotchas.
Search
Search the web with POST /v1/search: ranked results with titles, URLs and snippets, filtered by site, excluded domains, publish date or index date.
Qwen Audio Agent
Give Qwen Audio Agent’s voice assistant Keenable web search with QWEN_AUDIO_WEB_SEARCH_PROVIDER=keenable. No key needed, in release 2.1.0 and later.