From b56255ffaa7f17ba54ad3b27a613936e35ed9b95 Mon Sep 17 00:00:00 2001
From: Andreas Hilbig <andreas.hilbig@hilbigit.com>
Date: Sat, 31 Jan 2026 10:52:56 +0100
Subject: [PATCH] feat: add Zabbix 7.4 documentation samples and
 importHostGroups MCP tool

This commit introduces a comprehensive set of GraphQL query and mutation samples based on the official Zabbix 7.4 API documentation, along with testing and automation improvements.

Changes:

- Documentation:

  - Added 21 GraphQL sample files in docs/queries/from_zabbix_docs/ covering various Zabbix API operations.

  - Updated docs/howtos/cookbook.md with a new recipe for executing these documentation samples.

- AI & MCP:

  - Added mcp/operations/importHostGroups.graphql to enable host group import via MCP tools.

- Testing:

  - Added src/test/zabbix_docs_samples.test.ts to automatically validate all documentation samples against the GraphQL schema.
---
 docs/howtos/cookbook.md                       | 57 +++++++++++++
 .../from_zabbix_docs/allDevices.graphql       | 27 +++++++
 .../from_zabbix_docs/allHostGroups.graphql    | 18 +++++
 .../queries/from_zabbix_docs/allHosts.graphql | 34 ++++++++
 .../allTemplateGroups.graphql                 | 18 +++++
 .../from_zabbix_docs/createHost.graphql       | 23 ++++++
 .../deleteTemplateGroups.graphql              | 18 +++++
 .../from_zabbix_docs/deleteTemplates.graphql  | 18 +++++
 .../exportHostValueHistory.graphql            | 24 ++++++
 .../from_zabbix_docs/exportUserRights.graphql | 28 +++++++
 .../from_zabbix_docs/hasPermissions.graphql   | 20 +++++
 .../from_zabbix_docs/importHostGroups.graphql | 26 ++++++
 .../from_zabbix_docs/importHosts.graphql      | 30 +++++++
 .../importTemplateGroups.graphql              | 23 ++++++
 .../from_zabbix_docs/importTemplates.graphql  | 32 ++++++++
 .../from_zabbix_docs/importUserRights.graphql | 45 +++++++++++
 .../from_zabbix_docs/locations.graphql        | 19 +++++
 docs/queries/from_zabbix_docs/login.graphql   | 16 ++++
 docs/queries/from_zabbix_docs/logout.graphql  | 13 +++
 .../from_zabbix_docs/templates.graphql        | 18 +++++
 .../from_zabbix_docs/userPermissions.graphql  | 18 +++++
 .../from_zabbix_docs/zabbixVersion.graphql    | 13 +++
 mcp/operations/importHostGroups.graphql       |  7 ++
 src/test/zabbix_docs_samples.test.ts          | 81 +++++++++++++++++++
 24 files changed, 626 insertions(+)
 create mode 100644 docs/queries/from_zabbix_docs/allDevices.graphql
 create mode 100644 docs/queries/from_zabbix_docs/allHostGroups.graphql
 create mode 100644 docs/queries/from_zabbix_docs/allHosts.graphql
 create mode 100644 docs/queries/from_zabbix_docs/allTemplateGroups.graphql
 create mode 100644 docs/queries/from_zabbix_docs/createHost.graphql
 create mode 100644 docs/queries/from_zabbix_docs/deleteTemplateGroups.graphql
 create mode 100644 docs/queries/from_zabbix_docs/deleteTemplates.graphql
 create mode 100644 docs/queries/from_zabbix_docs/exportHostValueHistory.graphql
 create mode 100644 docs/queries/from_zabbix_docs/exportUserRights.graphql
 create mode 100644 docs/queries/from_zabbix_docs/hasPermissions.graphql
 create mode 100644 docs/queries/from_zabbix_docs/importHostGroups.graphql
 create mode 100644 docs/queries/from_zabbix_docs/importHosts.graphql
 create mode 100644 docs/queries/from_zabbix_docs/importTemplateGroups.graphql
 create mode 100644 docs/queries/from_zabbix_docs/importTemplates.graphql
 create mode 100644 docs/queries/from_zabbix_docs/importUserRights.graphql
 create mode 100644 docs/queries/from_zabbix_docs/locations.graphql
 create mode 100644 docs/queries/from_zabbix_docs/login.graphql
 create mode 100644 docs/queries/from_zabbix_docs/logout.graphql
 create mode 100644 docs/queries/from_zabbix_docs/templates.graphql
 create mode 100644 docs/queries/from_zabbix_docs/userPermissions.graphql
 create mode 100644 docs/queries/from_zabbix_docs/zabbixVersion.graphql
 create mode 100644 mcp/operations/importHostGroups.graphql
 create mode 100644 src/test/zabbix_docs_samples.test.ts

diff --git a/docs/howtos/cookbook.md b/docs/howtos/cookbook.md
index 7dc3877..b3d12e1 100644
--- a/docs/howtos/cookbook.md
+++ b/docs/howtos/cookbook.md
@@ -12,6 +12,63 @@ To generate a test case from a recipe:
 
 ---
 
+## 🍳 Recipe: Executing Zabbix 7.4 Documentation Samples
+
+This recipe shows how to execute standard Zabbix 7.4 API examples using their GraphQL equivalents. These samples are directly derived from the official Zabbix documentation and adapted for use with this GraphQL API.
+
+### 📋 Prerequisites
+- Zabbix GraphQL API is running.
+- You have a valid Zabbix user account and are logged in (or have an auth token).
+
+### 🛠️ Step 1: Browse Available Samples
+All samples derived from the Zabbix 7.4 documentation are stored in the following directory:
+- `docs/queries/from_zabbix_docs/`
+
+Each `.graphql` file in this directory contains a reference link to the original Zabbix documentation source.
+
+### ⚙️ Step 2: Extract Query and Variables
+Each sample file in `docs/queries/from_zabbix_docs/` is structured to include both the GraphQL operation and a corresponding set of sample variables.
+
+1.  **Open the Sample**: Open the desired `.graphql` file (e.g. `createHost.graphql`).
+2.  **Copy the Query**: Copy the GraphQL code block found under the `### Query` header.
+3.  **Copy the Variables**: Copy the JSON code block found under the `### Variables` header.
+
+### 🚀 Step 3: Execution/Action
+Choose a sample and execute it against the GraphQL endpoint using your preferred client (like Apollo Studio, GraphiQL, or Postman).
+
+- **Configure the Request**:
+    - Paste the **Query** into the operation window.
+    - Paste the **Variables** JSON into the variables window.
+- **Run the Operation**: Click "Execute" or "Play".
+
+#### Example: Creating a Host
+Using the content from `docs/queries/from_zabbix_docs/createHost.graphql`:
+
+**Query**:
+```graphql
+mutation CreateHost($host: String!, $hostgroupids: [Int!]!, $templateids: [Int!]!) {
+  createHost(host: $host, hostgroupids: $hostgroupids, templateids: $templateids) {
+    hostids
+  }
+}
+```
+
+**Variables**:
+```json
+{
+  "host": "Linux server",
+  "hostgroupids": [50],
+  "templateids": [20045]
+}
+```
+
+### ✅ Step 4: Verification
+Compare the GraphQL response with the expected output described in the Zabbix documentation. Note that while the field names in GraphQL match the Zabbix API field names (e.g. `hostid`, `host`), the structure is simplified and nested objects (like `hostgroups`) can be queried directly without separate `selectXXX` parameters.
+
+- *Reference*: [Zabbix 7.4 API Documentation](https://www.zabbix.com/documentation/7.4/en/manual/api)
+
+---
+
 ## 🍳 Recipe: Extending Schema with a New Device Type
 
 This recipe shows how to add support for a new specialized device type without modifying the core API code. We will use the `DistanceTrackerDevice` as an example.
diff --git a/docs/queries/from_zabbix_docs/allDevices.graphql b/docs/queries/from_zabbix_docs/allDevices.graphql
new file mode 100644
index 0000000..20ce582
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/allDevices.graphql
@@ -0,0 +1,27 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/host/get
+
+### Query
+```graphql
+query GetAllDevices($name_pattern: String) {
+  allDevices(name_pattern: $name_pattern) {
+    hostid
+    host
+    name
+    deviceType
+    state {
+      operational {
+        temperature
+        voltage
+        signalstrength
+      }
+    }
+  }
+}
+```
+
+### Variables
+```json
+{
+  "name_pattern": "Device%"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/allHostGroups.graphql b/docs/queries/from_zabbix_docs/allHostGroups.graphql
new file mode 100644
index 0000000..30de91d
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/allHostGroups.graphql
@@ -0,0 +1,18 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/hostgroup/get
+
+### Query
+```graphql
+query GetAllHostGroups($search_name: String) {
+  allHostGroups(search_name: $search_name) {
+    groupid
+    name
+  }
+}
+```
+
+### Variables
+```json
+{
+  "search_name": "Zabbix%"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/allHosts.graphql b/docs/queries/from_zabbix_docs/allHosts.graphql
new file mode 100644
index 0000000..d5e48de
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/allHosts.graphql
@@ -0,0 +1,34 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/host/get
+
+### Query
+```graphql
+query GetAllHosts($name_pattern: String, $groupids: [Int!]) {
+  allHosts(name_pattern: $name_pattern, groupids: $groupids) {
+    hostid
+    host
+    name
+    deviceType
+    hostgroups {
+      groupid
+      name
+    }
+    ... on ZabbixHost {
+      tags
+      items {
+        itemid
+        name
+        key_
+        lastvalue
+      }
+    }
+  }
+}
+```
+
+### Variables
+```json
+{
+  "name_pattern": "Linux%",
+  "groupids": [2]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/allTemplateGroups.graphql b/docs/queries/from_zabbix_docs/allTemplateGroups.graphql
new file mode 100644
index 0000000..a2c1de7
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/allTemplateGroups.graphql
@@ -0,0 +1,18 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/templategroup/get
+
+### Query
+```graphql
+query GetAllTemplateGroups($name_pattern: String) {
+  allTemplateGroups(name_pattern: $name_pattern) {
+    groupid
+    name
+  }
+}
+```
+
+### Variables
+```json
+{
+  "name_pattern": "Templates%"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/createHost.graphql b/docs/queries/from_zabbix_docs/createHost.graphql
new file mode 100644
index 0000000..e9e64d3
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/createHost.graphql
@@ -0,0 +1,23 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/host/create
+
+### Query
+```graphql
+mutation CreateHost($host: String!, $hostgroupids: [Int!]!, $templateids: [Int!]!) {
+  createHost(
+    host: $host,
+    hostgroupids: $hostgroupids,
+    templateids: $templateids
+  ) {
+    hostids
+  }
+}
+```
+
+### Variables
+```json
+{
+  "host": "Linux server",
+  "hostgroupids": [50],
+  "templateids": [20045]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/deleteTemplateGroups.graphql b/docs/queries/from_zabbix_docs/deleteTemplateGroups.graphql
new file mode 100644
index 0000000..eedd02a
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/deleteTemplateGroups.graphql
@@ -0,0 +1,18 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/templategroup/delete
+
+### Query
+```graphql
+mutation DeleteTemplateGroups($groupids: [Int!]) {
+  deleteTemplateGroups(groupids: $groupids) {
+    id
+    message
+  }
+}
+```
+
+### Variables
+```json
+{
+  "groupids": [10, 11]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/deleteTemplates.graphql b/docs/queries/from_zabbix_docs/deleteTemplates.graphql
new file mode 100644
index 0000000..a066bb2
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/deleteTemplates.graphql
@@ -0,0 +1,18 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/template/delete
+
+### Query
+```graphql
+mutation DeleteTemplates($templateids: [Int!]) {
+  deleteTemplates(templateids: $templateids) {
+    id
+    message
+  }
+}
+```
+
+### Variables
+```json
+{
+  "templateids": [10001, 10002]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/exportHostValueHistory.graphql b/docs/queries/from_zabbix_docs/exportHostValueHistory.graphql
new file mode 100644
index 0000000..c3d750e
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/exportHostValueHistory.graphql
@@ -0,0 +1,24 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/history/get
+
+### Query
+```graphql
+query ExportHostValueHistory($host_filter: [String!], $itemKey_filter: [String!], $limit: Int) {
+  exportHostValueHistory(
+    host_filter: $host_filter,
+    itemKey_filter: $itemKey_filter,
+    limit: $limit,
+    type: FLOAT
+  ) {
+    result
+  }
+}
+```
+
+### Variables
+```json
+{
+  "host_filter": ["Linux server"],
+  "itemKey_filter": ["system.cpu.load[all,avg1]"],
+  "limit": 10
+}
+```
diff --git a/docs/queries/from_zabbix_docs/exportUserRights.graphql b/docs/queries/from_zabbix_docs/exportUserRights.graphql
new file mode 100644
index 0000000..6aaa44d
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/exportUserRights.graphql
@@ -0,0 +1,28 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/usergroup/get
+
+### Query
+```graphql
+query ExportUserRights($name_pattern: String) {
+  exportUserRights(name_pattern: $name_pattern) {
+    userGroups {
+      usrgrpid
+      name
+      hostgroup_rights {
+        name
+        permission
+      }
+    }
+    userRoles {
+      roleid
+      name
+    }
+  }
+}
+```
+
+### Variables
+```json
+{
+  "name_pattern": "Zabbix%"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/hasPermissions.graphql b/docs/queries/from_zabbix_docs/hasPermissions.graphql
new file mode 100644
index 0000000..39dab49
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/hasPermissions.graphql
@@ -0,0 +1,20 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/usergroup/get
+
+### Query
+```graphql
+query HasPermissions($permissions: [PermissionRequest!]!) {
+  hasPermissions(permissions: $permissions)
+}
+```
+
+### Variables
+```json
+{
+  "permissions": [
+    {
+      "objectName": "Read-Only-Access",
+      "permission": "READ"
+    }
+  ]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/importHostGroups.graphql b/docs/queries/from_zabbix_docs/importHostGroups.graphql
new file mode 100644
index 0000000..ea544ac
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/importHostGroups.graphql
@@ -0,0 +1,26 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/hostgroup/create
+
+### Query
+```graphql
+mutation ImportHostGroups($hostGroups: [CreateHostGroup!]!) {
+  importHostGroups(hostGroups: $hostGroups) {
+    groupName
+    groupid
+    message
+  }
+}
+```
+
+### Variables
+```json
+{
+  "hostGroups": [
+    {
+      "groupName": "New Host Group 1"
+    },
+    {
+      "groupName": "New Host Group 2"
+    }
+  ]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/importHosts.graphql b/docs/queries/from_zabbix_docs/importHosts.graphql
new file mode 100644
index 0000000..9d446e8
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/importHosts.graphql
@@ -0,0 +1,30 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/host/create
+
+### Query
+```graphql
+mutation ImportHosts($hosts: [CreateHost!]!) {
+  importHosts(hosts: $hosts) {
+    hostid
+    deviceKey
+    message
+  }
+}
+```
+
+### Variables
+```json
+{
+  "hosts": [
+    {
+      "deviceKey": "Host 1",
+      "deviceType": "GenericDevice",
+      "groupNames": ["Zabbix servers"]
+    },
+    {
+      "deviceKey": "Host 2",
+      "deviceType": "GenericDevice",
+      "groupNames": ["Zabbix servers"]
+    }
+  ]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/importTemplateGroups.graphql b/docs/queries/from_zabbix_docs/importTemplateGroups.graphql
new file mode 100644
index 0000000..ba865a1
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/importTemplateGroups.graphql
@@ -0,0 +1,23 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/templategroup/create
+
+### Query
+```graphql
+mutation ImportTemplateGroups($templateGroups: [CreateTemplateGroup!]!) {
+  importTemplateGroups(templateGroups: $templateGroups) {
+    groupName
+    groupid
+    message
+  }
+}
+```
+
+### Variables
+```json
+{
+  "templateGroups": [
+    {
+      "groupName": "New Template Group 1"
+    }
+  ]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/importTemplates.graphql b/docs/queries/from_zabbix_docs/importTemplates.graphql
new file mode 100644
index 0000000..2a05998
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/importTemplates.graphql
@@ -0,0 +1,32 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/template/create
+
+### Query
+```graphql
+mutation ImportTemplates($templates: [CreateTemplate!]!) {
+  importTemplates(templates: $templates) {
+    templateid
+    host
+    message
+  }
+}
+```
+
+### Variables
+```json
+{
+  "templates": [
+    {
+      "host": "New Template 1",
+      "groupNames": ["Templates/Operating systems"],
+      "items": [
+        {
+          "name": "Custom item",
+          "key": "custom.item",
+          "value_type": 3,
+          "history": "90d"
+        }
+      ]
+    }
+  ]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/importUserRights.graphql b/docs/queries/from_zabbix_docs/importUserRights.graphql
new file mode 100644
index 0000000..f483b1f
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/importUserRights.graphql
@@ -0,0 +1,45 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/usergroup/create
+
+### Query
+```graphql
+mutation ImportUserRights($input: UserRightsInput!, $dryRun: Boolean!) {
+  importUserRights(input: $input, dryRun: $dryRun) {
+    userGroups {
+      id
+      name
+      message
+    }
+    userRoles {
+      id
+      name
+      message
+    }
+  }
+}
+```
+
+### Variables
+```json
+{
+  "dryRun": true,
+  "input": {
+    "userGroups": [
+      {
+        "name": "New User Group",
+        "hostgroup_rights": [
+          {
+            "name": "Zabbix servers",
+            "permission": "READ"
+          }
+        ]
+      }
+    ],
+    "userRoles": [
+      {
+        "name": "New Role",
+        "type": 1
+      }
+    ]
+  }
+}
+```
diff --git a/docs/queries/from_zabbix_docs/locations.graphql b/docs/queries/from_zabbix_docs/locations.graphql
new file mode 100644
index 0000000..14791c1
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/locations.graphql
@@ -0,0 +1,19 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/host/get
+
+### Query
+```graphql
+query GetLocations($name_pattern: String) {
+  locations(name_pattern: $name_pattern) {
+    name
+    latitude
+    longitude
+  }
+}
+```
+
+### Variables
+```json
+{
+  "name_pattern": "Riga%"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/login.graphql b/docs/queries/from_zabbix_docs/login.graphql
new file mode 100644
index 0000000..76f292f
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/login.graphql
@@ -0,0 +1,16 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/user/login
+
+### Query
+```graphql
+query Login($username: String!, $password: String!) {
+  login(username: $username, password: $password)
+}
+```
+
+### Variables
+```json
+{
+  "username": "Admin",
+  "password": "zabbix_password"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/logout.graphql b/docs/queries/from_zabbix_docs/logout.graphql
new file mode 100644
index 0000000..211cbc3
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/logout.graphql
@@ -0,0 +1,13 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/user/logout
+
+### Query
+```graphql
+query Logout {
+  logout
+}
+```
+
+### Variables
+```json
+{}
+```
diff --git a/docs/queries/from_zabbix_docs/templates.graphql b/docs/queries/from_zabbix_docs/templates.graphql
new file mode 100644
index 0000000..029ff12
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/templates.graphql
@@ -0,0 +1,18 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/template/get
+
+### Query
+```graphql
+query GetTemplates($name_pattern: String) {
+  templates(name_pattern: $name_pattern) {
+    templateid
+    name
+  }
+}
+```
+
+### Variables
+```json
+{
+  "name_pattern": "Template OS%"
+}
+```
diff --git a/docs/queries/from_zabbix_docs/userPermissions.graphql b/docs/queries/from_zabbix_docs/userPermissions.graphql
new file mode 100644
index 0000000..c583c9e
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/userPermissions.graphql
@@ -0,0 +1,18 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/user/get
+
+### Query
+```graphql
+query GetUserPermissions($objectNames: [String!]) {
+  userPermissions(objectNames: $objectNames) {
+    objectName
+    permission
+  }
+}
+```
+
+### Variables
+```json
+{
+  "objectNames": ["Read-Only-Access"]
+}
+```
diff --git a/docs/queries/from_zabbix_docs/zabbixVersion.graphql b/docs/queries/from_zabbix_docs/zabbixVersion.graphql
new file mode 100644
index 0000000..a9d2ca8
--- /dev/null
+++ b/docs/queries/from_zabbix_docs/zabbixVersion.graphql
@@ -0,0 +1,13 @@
+# Source: https://www.zabbix.com/documentation/7.4/en/manual/api/reference/apiinfo/version
+
+### Query
+```graphql
+query GetZabbixVersion {
+  zabbixVersion
+}
+```
+
+### Variables
+```json
+{}
+```
diff --git a/mcp/operations/importHostGroups.graphql b/mcp/operations/importHostGroups.graphql
new file mode 100644
index 0000000..cfc17cf
--- /dev/null
+++ b/mcp/operations/importHostGroups.graphql
@@ -0,0 +1,7 @@
+mutation ImportHostGroups($hostGroups: [CreateHostGroup!]!) {
+  importHostGroups(hostGroups: $hostGroups) {
+    groupName
+    groupid
+    message
+  }
+}
diff --git a/src/test/zabbix_docs_samples.test.ts b/src/test/zabbix_docs_samples.test.ts
new file mode 100644
index 0000000..87c189f
--- /dev/null
+++ b/src/test/zabbix_docs_samples.test.ts
@@ -0,0 +1,81 @@
+import {ApolloServer} from '@apollo/server';
+import {schema_loader} from '../api/schema.js';
+import {readdirSync, readFileSync} from 'fs';
+import {join} from 'path';
+import {zabbixAPI} from '../datasources/zabbix-api.js';
+
+// Mocking ZabbixAPI.post
+jest.mock("../datasources/zabbix-api.js", () => ({
+    zabbixAPI: {
+        post: jest.fn(),
+        executeRequest: jest.fn(),
+        baseURL: 'http://localhost/zabbix',
+        getLocations: jest.fn(),
+        requestByPath: jest.fn()
+    }
+}));
+
+describe("Zabbix Docs Samples Integration Tests", () => {
+    let server: ApolloServer;
+
+    beforeAll(async () => {
+        const schema = await schema_loader();
+        server = new ApolloServer({
+            schema,
+        });
+    });
+
+    const samplesDir = join(process.cwd(), 'docs', 'queries', 'from_zabbix_docs');
+    const files = readdirSync(samplesDir).filter(f => f.endsWith('.graphql'));
+
+    test.each(files)("Sample %s should execute successfully", async (file) => {
+        const filePath = join(samplesDir, file);
+        const content = readFileSync(filePath, 'utf-8').replace(/\r\n/g, '\n');
+        
+        const queryMatch = content.match(/```graphql\n([\s\S]*?)\n```/);
+        const variablesMatch = content.match(/```json\n([\s\S]*?)\n```/);
+        
+        if (!queryMatch) {
+            throw new Error(`No graphql block found in ${file}`);
+        }
+        
+        const query = queryMatch[1];
+        const variables = variablesMatch ? JSON.parse(variablesMatch[1]) : {};
+
+        // Setup a generic mock response based on the operation
+        (zabbixAPI.post as jest.Mock).mockImplementation((method: string) => {
+            if (method.includes('login')) return Promise.resolve("test-token");
+            if (method.includes('logout')) return Promise.resolve(true);
+            if (method.includes('get')) return Promise.resolve([]);
+            if (method.includes('create')) {
+                if (method.includes('host')) return Promise.resolve({hostids: ["10001"]});
+                if (method.includes('group')) return Promise.resolve({groupids: ["50"]});
+                if (method.includes('template')) return Promise.resolve({templateids: ["20001"]});
+                return Promise.resolve({ids: ["1"]});
+            }
+            if (method.includes('delete')) return Promise.resolve({ids: ["1"]});
+            if (method.includes('version')) return Promise.resolve("7.4.0");
+            return Promise.resolve({});
+        });
+
+        // Some operations use requestByPath or other methods
+        (zabbixAPI.requestByPath as jest.Mock).mockResolvedValue({ hostids: ["10001"], groupid: "50", templateid: "20001" });
+
+        const response = await server.executeOperation({
+            query: query,
+            variables: variables,
+        }, {
+            contextValue: { zabbixAuthToken: 'test-token', dataSources: { zabbixAPI: zabbixAPI } }
+        });
+
+        if (response.body.kind === 'single') {
+            const result = response.body.singleResult;
+            if (result.errors) {
+                console.error(`Errors in ${file}:`, JSON.stringify(result.errors, null, 2));
+            }
+            expect(result.errors).toBeUndefined();
+        } else {
+            throw new Error(`Unexpected response kind: ${response.body.kind}`);
+        }
+    });
+});