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
Related: Built-in tools reference

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.