> ## Documentation Index > Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # builtin_tools > Switches and configuration for the platform built-in tools — disable specific ones, control outbound-message recipients, and pick the web-search engine. # `builtin_tools` — Built-in tool settings Switches and configuration for the platform built-in tools — disable specific ones, control outbound-message recipients, and pick the web-search engine. **Section key** `builtin_tools` · **Shape** object · **Tier** Pro and up (free trial includes it)\ **Edit in the dashboard:** [Tools page](/sidebar-menu/tools)\ **Related:** [Built-in tools reference](/builtin-tools/index) ## Fields | Field | Required | Type | Allowed values / constraints | Default | Description | | ----------------------------- | -------- | --------------- | ------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `disabled` | no | array of string | — | — | Names of built-in tools disabled for this agent. | | `collapsed` | no | boolean | — | — | UI hint. | | `max_outbound_sends_per_day` | no | integer | min 0 | — | Per-agent DAILY cap on outbound messages this agent may send via its email\_send + im\_send tools (counted together in one daily counter that resets at 00:00 UTC). When omitted, the platform default from config/agent-limits.json (default\_outbound\_sends\_per\_day, default 100) applies. Set to 0 for unlimited. When the cap is reached, further email\_send / im\_send calls return a 'daily send limit reached' error until the next day. Owner-editable on the Tools page. | | `web_search_engine` | no | enum | one of `internal`, `anthropic` | — | Which engine backs web\_search/web\_fetch/execute\_code. 'anthropic' (default) registers the Anthropic server-side bundle (web\_search\_20260209 + web\_fetch\_20260209 + code\_execution\_20260120). 'internal' uses the platform tool stack (Brave/Tavily + Native/Jina/Firecrawl + Microsandbox/E2B). Anthropic mode is only honored when the agent is routed to an Anthropic model; on other providers the engine transparently falls back to the internal stack. | | `web_search_anthropic_config` | no | object | — | — | Optional config merged into the Anthropic web\_search\_20260209 wire object. All fields optional; blank means use Anthropic defaults. Edited from the main web\_search tile UI when web\_search\_engine='anthropic'. Wraps of web\_search store their own config separately on the tool entry. Item fields below. | ### `web_search_anthropic_config` fields Optional config merged into the Anthropic web\_search\_20260209 wire object. All fields optional; blank means use Anthropic defaults. Edited from the main web\_search tile UI when web\_search\_engine='anthropic'. Wraps of web\_search store their own config separately on the tool entry. | Field | Required | Type | Allowed values / constraints | Default | Description | | -------------------- | -------- | --------------- | ---------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `max_uses` | no | number | — | — | Maximum number of web\_search invocations the agent may make within a single API request. Passed to Anthropic's web\_search\_20260209 tool; blank uses Anthropic's default. | | `max_results` | no | number | — | — | Target number of search results to return per web\_search call (e.g. 5, 10, 20). Hint passed through to Anthropic; blank uses Anthropic defaults. | | `topic` | no | string | — | — | Topic hint (e.g. 'news', 'finance', 'academic') to guide search intent and result relevance. Passed to Anthropic; blank omits the hint. | | `user_location` | no | object | — | — | Geographic and timezone context object to improve result relevance for location-aware queries. All subfields optional; empty object means no location hint. Item fields below. | | `allowed_domains` | no | array of string | — | — | Array of domain names (e.g. \['nytimes.com', 'bbc.com']) to restrict search results to only these sources. Mutually exclusive with blocked\_domains; blank allows all domains. | | `blocked_domains` | no | array of string | — | — | Array of domain names to exclude from search results. Mutually exclusive with allowed\_domains; blank excludes nothing. Passed to Anthropic's web\_search\_20260209 tool. | | `max_content_tokens` | no | number | — | — | Token limit on fetched page content when web\_fetch is used to retrieve results from URLs. Applied per fetch; blank uses Anthropic defaults (typically \~8000 tokens). | ### `web_search_anthropic_config.user_location` fields Geographic and timezone context object to improve result relevance for location-aware queries. All subfields optional; empty object means no location hint. | Field | Required | Type | Allowed values / constraints | Default | Description | | ---------- | -------- | ------ | ---------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `type` | no | enum | one of `approximate` | — | Location precision level; only 'approximate' is supported, indicating the provided city/country/region/timezone are user-supplied hints, not exact coordinates. | | `city` | no | string | — | — | City name (e.g. 'San Francisco') to provide geographic context for searches. Optional; pair with country/region/timezone for best results. | | `country` | no | string | — | — | Country name or ISO code (e.g. 'US', 'United States') to provide geographic context. Optional; helps Anthropic return region-specific results. | | `region` | no | string | — | — | State, province, or region name (e.g. 'California', 'ON') to narrow geographic context. Optional; refines results within a country. | | `timezone` | no | string | — | — | IANA timezone identifier (e.g. 'America/Los\_Angeles', 'Europe/London') to provide temporal context. Helps Anthropic interpret time-relative queries and filter recent content. |