Change site settings
update_site_settingsChange site settings. Send only the fields to change: name, timezone (IANA, e.g. Europe/Berlin), currency (ISO code), kpi ("revenue", "mrr" or "goal:"), color (#RRGGBB), cookieless, weekly_report, spike_alert, the usage controls excluded_paths, excluded_hostnames, drop_pings and pageview_sample_rate (they lower the data recorded; ask the user first), the exclusion lists excluded_ips, excluded_countries and hidden_countries (each replaces the whole list; to add or remove one entry use update_exclusions), and attack_mode / attack_mode_auto (attack mode filters spam during a bot attack: new visits count only after a click, scroll or key press, fast repeat hits and referrer spam are dropped; real visitors who do not interact are left out too, so ask the user first), and count_cloud_visits (true counts visits from cloud and hosting networks such as AWS, Google Cloud and Azure as people; by default they are likely bots and left out of people, reports and usage). is_public and public_slug publish the dashboard at /share/ for anyone; they need the admin scope, so ask the user first. list_sites shows the current values.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "update_site_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kpi | No | ||
| name | No | ||
| site | No | Site domain (example.com), id or public id (tb_…). Optional with a site key, or when the account has one site. | |
| color | No | ||
| currency | No | ||
| timezone | No | ||
| is_public | No | ||
| cookieless | No | ||
| drop_pings | No | true = do not record ping events (time on the last page). Visit durations get shorter. | |
| attack_mode | No | true = attack mode on: stricter rules against a bot attack (see /docs/privacy#attack-mode). list_sites shows attack_mode_since. | |
| public_slug | No | ||
| spike_alert | No | ||
| excluded_ips | No | Replaces the list. IP addresses and ranges not to record: 203.0.113.7, 203.0.113.0/24, 2001:db8::/48. | |
| weekly_report | No | ||
| excluded_paths | No | Replaces the list. Paths not to record, like /admin/** (* = one segment, ** = any depth). | |
| attack_mode_auto | No | true = turn attack mode on when a traffic spike starts, and off after 24 hours of normal traffic. The owner gets an email each time. | |
| hidden_countries | No | Replaces the list. Countries whose past data every report leaves out (nothing is deleted); each is excluded too. Ask the user first. | |
| count_cloud_visits | No | true = count browser visits from cloud and hosting networks (AWS, Google Cloud, Azure, Oracle, DigitalOcean, Linode, Hetzner, OVHcloud, GitHub Actions) as people. Default false: they are likely bots, so people, reports, conversion rates and usage leave them out, and the bot card shows them under Cloud networks. Turn it on only when real visitors use cloud desktops or VPNs in data centres. Applies to new visits. | |
| excluded_countries | No | Replaces the list. ISO codes or English names whose new visits are not recorded. | |
| excluded_hostnames | No | Replaces the list. Hosts not to record, like staging.example.com. | |
| pageview_sample_rate | No | Percent of visitors whose page views are kept: 100, 50, 25, 10. 100 = off (default). Only for very high traffic; see get_usage. |