Title98/100
Search Web and Current Facts
The title clearly communicates the tool’s action and subject. Keep it concise.
Description84/100
Searches the public web and returns compact, structured results. Appropriate when the user requests current public information, source-backed research, or help finding a relevant page. When a user-requested task needs details from a result, its URL can be passed to fetch_content. Optionally provide purpose — a short statement of why you are searching and what the results are for — so results can be ranked against the underlying intent; it is not required and may be omitted. Supports geo-targeting (location), language filtering, recency_minutes for past-N-minute freshness, and after_date / before_date for YYYY-MM-DD date windows. Do not combine recency_minutes with after_date or before_date. Use domain_type to scope the search: "web" (default), "news" for news articles, or "research_paper" for academic papers. For domain_type=research_paper, use pub_year_min / pub_year_max instead to scope by publication year (inclusive) — after_date, before_date, and recency_minutes are not supported for research_paper. Use include_domains / exclude_domains (comma-separated domain lists) to restrict or remove specific domains from results. Use page (0-indexed, 0-10) to paginate through results.
The description explains the capability, when to use it, and what to expect.
Inputs70/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Search query
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
purpose
Why this search is being run — the underlying goal or task the results will be used for. Used to better rank results against your intent.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
location
Country code for geo-targeted results
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
language
Language code for result language
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
include_domains
Comma-separated list of domains to restrict results to
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
exclude_domains
Comma-separated list of domains to exclude from results
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
domain_type
Type of search to perform: "web" for standard results, "news" for news articles, "research_paper" for academic papers. Defaults to "web".
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
after_date
Return results after this date (YYYY-MM-DD)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
before_date
Return results before this date (YYYY-MM-DD)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
recency_minutes
Return results from the past N minutes (1 to 5,256,000).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
pub_year_min
Return research papers published on or after this year (0-9999, inclusive). Only supported for domain_type=research_paper.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
pub_year_max
Return research papers published on or before this year (0-9999, inclusive). Only supported for domain_type=research_paper.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page
Page number for pagination, starting from 0 (max 10)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
include_thumbnail
When "true", each result includes a thumbnail_url when available. Defaults to false.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
fetch
JSON-encoded fetch configuration object.
Explain the meaning of this value, not just its name.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}Output schema0/100
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared