Update Settings
updateSettingsChange Uptime Kuma server settings by sending only the values to modify; unspecified settings keep stored values, and the saved settings are returned.
Instructions
Changes Uptime Kuma server settings. Pass only what should change; every other setting keeps its stored value. Returns the settings as saved. Turning login off (disableAuth: true) needs currentPassword and leaves the dashboard open to anyone who can reach it. Read the current values with getSettings.
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": "updateSettings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nscd | No | Cache DNS lookups with NSCD (Docker images only) | |
| entryPage | No | What "/" opens: "dashboard", or a status page as "statusPage-<slug>". Find slugs with listStatusPages. | |
| apiEnabled | No | The "API" switch in Settings > General | |
| trustProxy | No | Trust X-Forwarded-* headers. Set only when Uptime Kuma sits behind a reverse proxy. | |
| checkUpdate | No | Show when a new Uptime Kuma version is available | |
| disableAuth | No | true turns login off: anyone who can reach Uptime Kuma gets full control. Needs currentPassword. false turns login back on and logs out every other session. | |
| steamAPIKey | No | Steam Web API key, used by Steam game server monitors. A credential: "***" (what read tools return) keeps the stored key, "" clears it. | |
| includeSecrets | No | Return credentials in full instead of "***"; they then stay in the transcript. Default: false, or UPTIME_KUMA_INCLUDE_SECRETS. | |
| primaryBaseURL | No | The public address of this Uptime Kuma, used for links in notifications, e.g. "https://status.example.com". "" clears it. | |
| serverTimezone | No | IANA timezone the server shows times and schedules maintenance in, e.g. "America/Edmonton" or "UTC" | |
| currentPassword | No | The admin password. Required only to turn login off (disableAuth: true) while it is on; never stored or returned. | |
| chromeExecutable | No | Path of the Chrome or Chromium binary real-browser monitors run, e.g. "/usr/bin/chromium". "" auto-detects. Changing it restarts the browser. | |
| searchEngineIndex | No | Let search engines index status pages | |
| globalpingApiToken | No | Globalping API token, used by globalping monitors. A credential: "***" (what read tools return) keeps the stored token, "" clears it. | |
| keepDataPeriodDays | No | Days of heartbeat history to keep; older beats are deleted | |
| tlsExpiryNotifyDays | No | Days before a TLS certificate expires to send a warning, e.g. [7, 14, 21]. Replaces the whole list. | |
| prometheusApiEnabled | No | Collect Prometheus metrics. Changing it starts or stops the collection. | |
| domainExpiryNotifyDays | No | Days before a domain registration expires to send a warning. Replaces the whole list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| msg | No | ||
| changed | Yes | The settings this call changed | |
| settings | Yes | Uptime Kuma server settings after the change |