web_search
Neural and keyword web search over the live web. Returns ranked results with title, URL, publication date and author, optionally with the page text. Sub-second on repeat queries (5-minute cache).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "web_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Search mode (default auto) | |
| async | No | If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts. | |
| query | Yes | The search query | |
| category | No | Restrict results to one kind of page | |
| numResults | No | How many results (default 10) | |
| includeText | No | Include the page text in each result (default false) | |
| excludeDomains | No | ||
| includeDomains | No | ||
| startPublishedDate | No | ISO-8601 date; only pages published after it |