Skip to main content
Glama
Sign In
Zabbix MCP Server

Zabbix MCP Server

by initMAX
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

settings_get

Read-only

Retrieve global Zabbix server settings, including default theme, frontend URL, login/session parameters, severity names and colors, and other defaults for configuration review.

Instructions

Get global Zabbix server settings. Returns the singleton settings object containing: default theme, server name, frontend URL, alert notification timeout, severity name overrides, severity colors, custom color settings, login and session parameters, and various other global defaults. No filtering options -- returns the full object.

Input Schema

NameRequiredDescriptionDefault
outputNoProperties of the settings object to return. Pass 'extend' for all, or a list of property names. Default when omitted: 'extend'. Properties: alert_usrgrpid, apm_global_db (8.0+), auditlog_enabled (6.0+), auditlog_mode (7.0+), blink_period, connect_timeout, custom_color, default_inventory_mode, default_lang, default_theme, default_timezone, device_link_timeout (8.0+), discovery_groupid, geomaps_attribution (6.0+), geomaps_max_zoom (6.0+), geomaps_tile_provider (6.0+), geomaps_tile_url (6.0+), ha_failover_delay (6.0+), history_period, iframe_sandboxing_enabled, iframe_sandboxing_exceptions, item_test_timeout, login_attempts, login_block, max_in_table, max_overview_table_size, max_period, media_type_test_timeout, ok_ack_color, ok_ack_style, ok_period, ok_unack_color, ok_unack_style, period_default, problem_ack_color, problem_ack_style, problem_unack_color, problem_unack_style, proxy_secrets_provider (7.4+), report_test_timeout (5.4+), script_timeout, search_limit, server_check_interval, serverid (8.0+), severity_color_0, severity_color_1, severity_color_2, severity_color_3, severity_color_4, severity_color_5, severity_name_0, severity_name_1, severity_name_2, severity_name_3, severity_name_4, severity_name_5, show_technical_errors, snmptrap_logging, socket_timeout, timeout_browser (7.0+), timeout_db_monitor (7.0+), timeout_external_check (7.0+), timeout_http_agent (7.0+), timeout_script (7.0+), timeout_simple_check (7.0+), timeout_snmp_agent (7.0+), timeout_ssh_agent (7.0+), timeout_telemetry_query (8.0+), timeout_telnet_agent (7.0+), timeout_zabbix_agent (7.0+), uri_valid_schemes, url (5.4+), validate_uri_schemes, vault_provider (6.2+), work_period, x_frame_options.
serverNoTarget Zabbix server. Available: default. Defaults to 'default' if omitted.
raw_jsonNoStrips the security disclaimer preamble from the response so it is pure JSON. Default: false. Requires the bearer token to have 'allow_raw_json' explicitly enabled by an operator in the admin portal - tokens without that policy receive a PolicyError instead. WARNING: setting true bypasses the prompt-injection mitigation marker that wraps untrusted Zabbix data (host names, item descriptions, problem text). LLM clients (Claude, GPT, Cursor, ...) should leave this false; only programmatic non-LLM consumers (Python scripts, n8n workflows that json.loads the result) should set true.
extra_paramsNoOther native settings.get parameters, merged into the request as-is. settings.get has no parameters beyond the typed ones. Any other key is refused here, because Zabbix would silently ignore it. For a parameter you are sure exists on your release but is not listed, use zabbix_raw_api_call.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv1.42.2
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / extra_params / anyOf
      Previous value: -[
-  {
-    "additionalProperties": true,
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedInput schema / properties / output / anyOf
      Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "extend"
+    ],
+    "type": "string"
+  },
+  {
+    "items": {
+      "enum": [
+        "alert_usrgrpid",
+        "apm_global_db",
+        "auditlog_enabled",
+        "auditlog_mode",
+        "blink_period",
+        "connect_timeout",
+        "custom_color",
+        "default_inventory_mode",
+        "default_lang",
+        "default_theme",
+        "default_timezone",
+        "device_link_timeout",
+        "discovery_groupid",
+        "geomaps_attribution",
+        "geomaps_max_zoom",
+        "geomaps_tile_provider",
+        "geomaps_tile_url",
+        "ha_failover_delay",
+        "history_period",
+        "iframe_sandboxing_enabled",
+        "iframe_sandboxing_exceptions",
+        "item_test_timeout",
+        "login_attempts",
+        "login_block",
+        "max_in_table",
+        "max_overview_table_size",
+        "max_period",
+        "media_type_test_timeout",
+        "ok_ack_color",
+        "ok_ack_style",
+        "ok_period",
+        "ok_unack_color",
+        "ok_unack_style",
+        "period_default",
+        "problem_ack_color",
+        "problem_ack_style",
+        "problem_unack_color",
+        "problem_unack_style",
+        "proxy_secrets_provider",
+        "report_test_timeout",
+        "script_timeout",
+        "search_limit",
+        "server_check_interval",
+        "serverid",
+        "severity_color_0",
+        "severity_color_1",
+        "severity_color_2",
+        "severity_color_3",
+        "severity_color_4",
+        "severity_color_5",
+        "severity_name_0",
+        "severity_name_1",
+        "severity_name_2",
+        "severity_name_3",
+        "severity_name_4",
+        "severity_name_5",
+        "show_technical_errors",
+        "snmptrap_logging",
+        "socket_timeout",
+        "timeout_browser",
+        "timeout_db_monitor",
+        "timeout_external_check",
+        "timeout_http_agent",
+        "timeout_script",
+        "timeout_simple_check",
+        "timeout_snmp_agent",
+        "timeout_ssh_agent",
+        "timeout_telemetry_query",
+        "timeout_telnet_agent",
+        "timeout_zabbix_agent",
+        "uri_valid_schemes",
+        "url",
+        "validate_uri_schemes",
+        "vault_provider",
+        "work_period",
+        "x_frame_options",
+        "session_key"
+      ],
+      "type": "string"
+    },
+    "minItems": 1,
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedInput schema / properties / output / description
      Previous value: -"Properties of the settings object to return. Pass 'extend' for all, 'count' for the number of matches only, or a comma-separated list of property names. Default when omitted: 'extend'. Properties: alert_usrgrpid, apm_global_db (8.0+), auditlog_enabled (6.0+), auditlog_mode (7.0+), blink_period, connect_timeout, custom_color, default_inventory_mode, default_lang, default_theme, default_timezone, device_link_timeout (8.0+), discovery_groupid, geomaps_attribution (6.0+), geomaps_max_zoom (6.0+), geomaps_tile_provider (6.0+), geomaps_tile_url (6.0+), ha_failover_delay (6.0+), history_period, iframe_sandboxing_enabled, iframe_sandboxing_exceptions, item_test_timeout, login_attempts, login_block, max_in_table, max_overview_table_size, max_period, media_type_test_timeout, ok_ack_color, ok_ack_style, ok_period, ok_unack_color, ok_unack_style, period_default, problem_ack_color, problem_ack_style, problem_unack_color, problem_unack_style, proxy_secrets_provider (7.4+), report_test_timeout (5.4+), script_timeout, search_limit, server_check_interval, serverid (8.0+), severity_color_0, severity_color_1, severity_color_2, severity_color_3, severity_color_4, severity_color_5, severity_name_0, severity_name_1, severity_name_2, severity_name_3, severity_name_4, severity_name_5, show_technical_errors, snmptrap_logging, socket_timeout, timeout_browser (7.0+), timeout_db_monitor (7.0+), timeout_external_check (7.0+), timeout_http_agent (7.0+), timeout_script (7.0+), timeout_simple_check (7.0+), timeout_snmp_agent (7.0+), timeout_ssh_agent (7.0+), timeout_telemetry_query (8.0+), timeout_telnet_agent (7.0+), timeout_zabbix_agent (7.0+), uri_valid_schemes, url (5.4+), validate_uri_schemes, vault_provider (6.2+), work_period, x_frame_options."New value: +"Properties of the settings object to return. Pass 'extend' for all, or a list of property names. Default when omitted: 'extend'. Properties: alert_usrgrpid, apm_global_db (8.0+), auditlog_enabled (6.0+), auditlog_mode (7.0+), blink_period, connect_timeout, custom_color, default_inventory_mode, default_lang, default_theme, default_timezone, device_link_timeout (8.0+), discovery_groupid, geomaps_attribution (6.0+), geomaps_max_zoom (6.0+), geomaps_tile_provider (6.0+), geomaps_tile_url (6.0+), ha_failover_delay (6.0+), history_period, iframe_sandboxing_enabled, iframe_sandboxing_exceptions, item_test_timeout, login_attempts, login_block, max_in_table, max_overview_table_size, max_period, media_type_test_timeout, ok_ack_color, ok_ack_style, ok_period, ok_unack_color, ok_unack_style, period_default, problem_ack_color, problem_ack_style, problem_unack_color, problem_unack_style, proxy_secrets_provider (7.4+), report_test_timeout (5.4+), script_timeout, search_limit, server_check_interval, serverid (8.0+), severity_color_0, severity_color_1, severity_color_2, severity_color_3, severity_color_4, severity_color_5, severity_name_0, severity_name_1, severity_name_2, severity_name_3, severity_name_4, severity_name_5, show_technical_errors, snmptrap_logging, socket_timeout, timeout_browser (7.0+), timeout_db_monitor (7.0+), timeout_external_check (7.0+), timeout_http_agent (7.0+), timeout_script (7.0+), timeout_simple_check (7.0+), timeout_snmp_agent (7.0+), timeout_ssh_agent (7.0+), timeout_telemetry_query (8.0+), timeout_telnet_agent (7.0+), timeout_zabbix_agent (7.0+), uri_valid_schemes, url (5.4+), validate_uri_schemes, vault_provider (6.2+), work_period, x_frame_options."
    • changedOutput schema / (root)
      Previous value: -{
-  "properties": {
-    "result": {
-      "title": "Result",
-      "type": "string"
-    }
-  },
-  "required": [
-    "result"
-  ],
-  "title": "settings_getOutput",
-  "type": "object"
-}New value: +null
  2. First observedv1.41.0

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description adds that the result is a singleton full object with no filtering, but says nothing about prerequisites such as authentication or permissions, nor that sensitive fields like session_key may be exposed -- detail that would matter for an agent deciding whether to read and relay the result.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with the verb and resource, then the return shape, then the no-filtering constraint. The enumeration of returned fields is lengthy and partially duplicates the schema's property list, costing a little efficiency without obscuring the core point.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only singleton getter with full schema coverage and safety annotations, the description says enough to call it correctly: what it returns, that it is one object, and that no filtering exists. Missing only peripheral context such as auth requirements or handling of credential-like fields such as session_key.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%: output, server, raw_json, and extra_params are each documented in the schema, including version-gated property names and the raw_json policy warning. The description adds nothing about parameter behavior beyond reiterating that no filtering is available, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Get global Zabbix server settings') and enumerates the singleton object's contents (default theme, server name, frontend URL, severity overrides/colors, login and session parameters), which separates it from object-specific getters like host_get or item_get. It stops short of explicitly distinguishing it from nearby look-alikes such as serverinfo_get, authentication_get, or housekeeping_get, leaving the agent to infer the boundary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'No filtering options -- returns the full object' tells the agent not to expect narrow queries, but there is no explicit when-to-use guidance and no named alternative for cases where a narrower settings-related call (authentication_get, housekeeping_get) would be better. Usage is implied by the resource scope rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools