titan_search when your agent has a question but not the URLs. It returns metadata-only organic results—ranked URLs, titles, and snippets. To read the pages, follow up with titan_fetch.
Required scope: mcp:search
Parameters
The search query. Raw search operators you type here (
"exact phrase", -excluded, OR) are passed through to the provider.Identifier of the search platform to query. Call
titan_list_templates with action_type: "search" to see the platforms available to your account. Defaults to the platform default when omitted.Selection is explicit—there is no automatic fallback to a different platform if one fails.Results to return, up to 100. Requesting more than you will read wastes time, not credits: search bills per run, not per result.
How to combine
query with the structured fields below.raw— sendqueryuntouched, ignore structured fieldsstructured— build the query from structured fields onlyraw_and_structured— combine both
Deduplicate repeated calls for 24 hours. See Idempotency and retries.
Operator support
Search platforms differ in which operators they accept. Unsupported fields are dropped, not rejected—your search still runs, and each dropped field is reported inwarnings with code operator_unsupported naming exactly what was removed.
Quoted phrases, -term exclusions, OR alternation, include_domains, and exclude_domains work everywhere. Support for file_types, title_terms, url_terms, country, language, and freshness varies.
Example
Find recent PDFs on a specific domain:Response
Result fields
Inspect
query in the response to see exactly how your structured fields compiled. That is the fastest way to debug a search that returned nothing useful.Credits
One credit per search run, regardless of how many results you request. A search that completes and confidently returns zero organic results is still billable—it delivered a valid answer. A search that is blocked, rate-limited, or times out with no records is not billed. See Credits and usage.Warnings you may see
Common patterns
Narrow to a source you trustNext steps
- titan_fetch — read the pages you discovered
- Research agent example — search and fetch as one pipeline
- Errors and warnings