zabbix-mcp-server

Instructions

Args:
    name: Item name
    key_: Item key
    hostid: Host ID
    type: Item type (0=Zabbix agent, 2=Zabbix trapper, etc.)
    value_type: Value type (0=float, 1=character, 3=unsigned int, 4=text)
    delay: Update interval
    units: Value units
    description: Item description
    
Returns:
    str: JSON formatted creation result

Implementation Reference

• src/zabbix_mcp_server.py:370-409 (handler)

  The handler function for the 'item_create' tool, registered via @mcp.tool() decorator. It validates read-only mode, gets the Zabbix API client, constructs parameters for item creation, calls client.item.create(), and returns formatted JSON response.

  @mcp.tool()
  def item_create(name: str, key_: str, hostid: str, type: int,
                  value_type: int, delay: str = "1m",
                  units: Optional[str] = None,
                  description: Optional[str] = None) -> str:
      """Create a new item in Zabbix.
      
      Args:
          name: Item name
          key_: Item key
          hostid: Host ID
          type: Item type (0=Zabbix agent, 2=Zabbix trapper, etc.)
          value_type: Value type (0=float, 1=character, 3=unsigned int, 4=text)
          delay: Update interval
          units: Value units
          description: Item description
          
      Returns:
          str: JSON formatted creation result
      """
      validate_read_only()
      
      client = get_zabbix_client()
      params = {
          "name": name,
          "key_": key_,
          "hostid": hostid,
          "type": type,
          "value_type": value_type,
          "delay": delay
      }
      
      if units:
          params["units"] = units
      if description:
          params["description"] = description
      
      result = client.item.create(**params)
      return format_response(result)