web-search
web_searchWeb search with page content: search the web and read the top pages in ONE call. Returns 10 results (title, url, snippet, date) plus the clean text of the best pages (read 1-5), with fetch time, sha256, publication and last-modified dates (each with its source) and canonical URL; a complete flag, and require_complete for all-or-nothing (not charged). French and Canada by default for French queries; official-sources mode (governments, registries, courts, laws); freshness filter; site: restriction. No results = HTTP 404 = not charged. Input: query, optional read, official, lang, country, freshness, site. Costs $0.008 USDC per call (x402 v2, Base or Solana). Send the HTTP header PAYMENT-SIGNATURE with your x402 payment, or call POST https://tolca.tonbot.ca/v1/web-search with an x402 client.
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 |
|---|---|---|---|
| lang | No | Search language: auto (detected from the query), fr or en | |
| read | No | Top pages to fetch and return as clean text (default 3) | |
| site | No | Restrict to one domain | |
| query | Yes | Question or keywords; Brave operators allowed (site:, "exact", -word) | |
| country | No | ISO country to prioritize (default CA) | |
| official | No | Only governments, registries, courts, laws | |
| freshness | No | Only results from the last 24h, 7d or 30d (default none) | |
| max_chars | No | Max characters of text per page (default 6,000; up to 50,000 for whole pages) | |
| require_complete | No | If true, a call that cannot read every available page returns an error and is not charged |