{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.mangoinventory.com",
    "site": "mangoinventory.com",
    "addresses": [
      {
        "address": "104.18.12.229",
        "endpoints": 15,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.18.0.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.18.13.229",
        "endpoints": 15,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.18.0.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700::6812:ce5",
        "endpoints": 15,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700::/44",
          "country": "US"
        }
      },
      {
        "address": "2606:4700::6812:de5",
        "endpoints": 15,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700::/44",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.18.12.229",
          "104.18.13.229",
          "2606:4700::6812:ce5",
          "2606:4700::6812:de5"
        ],
        "first_seen": "2026-11-22T15:25:03.111Z",
        "last_seen": "2026-11-22T15:25:03.111Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "mango-inventory",
      "version": "2.35.2",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "via": "1.1 Caddy",
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 14,
      "sample": [
        {
          "id": "633",
          "url": "https://api.cueframe.ai/v1/mcp",
          "server_name": "ai.cueframe/cueframe",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:45:03.459Z"
        },
        {
          "id": "2475",
          "url": "https://mcp.stork.ai/core",
          "server_name": "ai.stork/core",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:50:04.869Z"
        },
        {
          "id": "2476",
          "url": "https://mcp.stork.ai/mcp",
          "server_name": "ai.stork/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:51:08.332Z"
        },
        {
          "id": "2477",
          "url": "https://mcp.stork.ai/mcp?tools=directory",
          "server_name": "ai.stork/mcp-directory",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:52:02.549Z"
        },
        {
          "id": "15052",
          "url": "https://api.rentalcal.com/mcp",
          "server_name": "com.rentalcal/rentalcal",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T16:10:04.030Z"
        },
        {
          "id": "24144",
          "url": "https://api.convalytics.dev/mcp",
          "server_name": "io.github.Dan-Cleary/convalytics",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T13:48:02.253Z"
        },
        {
          "id": "18116",
          "url": "https://mcp.vokabulo.com/mcp",
          "server_name": "com.vokabulo/vocabulary-trainer",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T11:51:01.721Z"
        },
        {
          "id": "27053",
          "url": "https://web.svgapp.ai/mcp",
          "server_name": "io.github.Xyz3R/svgapp",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T14:40:03.010Z"
        },
        {
          "id": "30010",
          "url": "https://api.fulcru.app/mcp",
          "server_name": "io.github.gsmmediaro/fulcru",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T15:41:02.263Z"
        },
        {
          "id": "36248",
          "url": "https://api.rctrl.com/mcp",
          "server_name": "io.github.rankcontrol/rankcontrol",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T16:51:03.088Z"
        },
        {
          "id": "39790",
          "url": "https://mcp.thecloud.so/mcp",
          "server_name": "io.github.tekalabs/the-cloud",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T17:17:02.047Z"
        },
        {
          "id": "41018",
          "url": "https://mcp.savethisone.com/mcp",
          "server_name": "io.github.yemyat/save-this-one",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T17:39:01.600Z"
        },
        {
          "id": "43918",
          "url": "https://api.eureka.md/mcp",
          "server_name": "md.eureka/eureka",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T18:30:09.262Z"
        },
        {
          "id": "44072",
          "url": "https://api.candor.money/mcp",
          "server_name": "money.candor/candor-finance",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T18:36:02.777Z"
        }
      ]
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.mangoinventory",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "12469",
    "server_name": "com.mangoinventory/mango-inventory",
    "url": "https://mcp.mangoinventory.com/mcp",
    "host": "mcp.mangoinventory.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T15:25:03.111Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "a9c8ffa5feaee244e4faf810ba83b3c9e60fea070948187a82dd37a9d820d927",
    "first_listed_at": "2026-11-21T09:35:02.954Z",
    "created_at": "2026-11-21T06:10:09.341Z",
    "resolved_addresses": [
      "104.18.12.229",
      "104.18.13.229",
      "2606:4700::6812:ce5",
      "2606:4700::6812:de5"
    ]
  },
  "server": {
    "name": "com.mangoinventory/mango-inventory",
    "title": "Mango Inventory",
    "description": "Inventory for organisations with a lot of equipment: set up, import, check out, report, by chat.",
    "version": "1.0.2",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://mangoinventory.com/en/ai-agents",
    "published_at": "2026-11-19T20:16:05.717Z",
    "updated_at": "2026-11-19T20:16:05.717Z",
    "first_seen": "2026-11-21T06:10:09.236Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T16:20:18.298Z"
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1329,
    "first_check_in_window": "2026-11-21T09:35:02.954Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "a9c8ffa5feaee244e4faf810ba83b3c9e60fea070948187a82dd37a9d820d927",
    "tools": 60,
    "resources": 8,
    "prompts": 0,
    "first_seen": "2026-11-22T15:25:04.452Z",
    "tool_names": [
      "search_items",
      "show_items",
      "inventory_overview",
      "get_item",
      "check_item_availability",
      "search_resources",
      "list_resources",
      "get_item_requirements",
      "preview_item_create",
      "create_item",
      "assign_item",
      "pack_item",
      "unpack_item",
      "transfer_stock",
      "create_ticket",
      "list_tickets",
      "update_ticket",
      "set_item_status",
      "list_orders",
      "create_order",
      "fulfill_order",
      "reject_order",
      "cancel_order",
      "stocktaking_status",
      "get_setup_status",
      "scaffold_categories",
      "scaffold_locations",
      "scaffold_models",
      "create_category",
      "update_category",
      "archive_category",
      "create_field_def",
      "update_field_def",
      "create_location",
      "create_person",
      "set_org_type",
      "set_org_defaults",
      "create_invite",
      "list_members",
      "sample_data",
      "update_item",
      "my_tasks",
      "maintenance_status",
      "add_comment",
      "list_comments",
      "list_activity",
      "adjust_stock",
      "set_min_stock",
      "create_team",
      "add_team_member",
      "list_teams",
      "get_setup_template",
      "plan_import",
      "run_import",
      "check_fit",
      "quote",
      "find_docs",
      "tell_us",
      "create_account",
      "send_feedback"
    ],
    "declared": {
      "tools": [
        {
          "name": "search_items",
          "title": "Search items",
          "description": "Search inventory items. `search` matches exact item codes and barcode labels first (e.g. \"BM-002\" printed on an asset tag), then names: word-prefix (\"Lap\" matches all laptops) plus an accent-insensitive substring pass (\"stuhl\" finds \"Stühle\" and \"Bürostuhl\"). The query is never shortened, so \"Stühle\" does not find \"Bürostuhl\": a shorter stem matches more. An empty result [] means no match. Filters, combinable with `search` and with each other: currentHolderId (a person resource id, or \"me\" for the connected user), categoryId, currentLocationId, status. categoryId and currentLocationId include the whole subtree by default (a top-level category returns its subcategories' items, a building its rooms' items); categoryMatch / currentLocationMatch \"exact\" limits the match to that node. Every non-draft item has a category; inventory_overview returns the category tree and list_resources the location and people trees whose node ids these filters take. No arguments lists the newest items. In results, `status` is the item's CONDITION (available = not defect/lost/retired), so an available item may still be borrowed (`currentHolder`). A row without `trackingMode` is one physical item; a \"quantity\" row is a stock pool whose count is `quantity`. `primaryCode` is the code printed on the asset tag, the one way to tell two identical models apart. `webUrl` / `listUrl` open the record and the filtered list in the web app. Rows carry no photo: get_item (one item) and show_items (a picker of several) return photos. Drafts (unreviewed captures, `isDraft`) are personal: results include only the connected user's own drafts, never another user's (admins included), not even by exact code or id.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "0-based page index"
              },
              "search": {
                "type": "string",
                "description": "Item code (exact match, e.g. BM-002) or name words (word-prefix plus accent-insensitive substring)"
              },
              "status": {
                "enum": [
                  "available",
                  "in_repair",
                  "defect",
                  "lost",
                  "retired"
                ],
                "type": "string",
                "description": "Filter by condition. \"available\" means not defect/lost/retired — the item may still be borrowed."
              },
              "pageSize": {
                "type": "integer",
                "maximum": 50,
                "minimum": 1,
                "description": "Items per page, max 50 (default 20)"
              },
              "categoryId": {
                "type": "string",
                "description": "Filter by category id. Includes the whole subtree by default — see categoryMatch"
              },
              "categoryMatch": {
                "enum": [
                  "subtree",
                  "exact"
                ],
                "type": "string",
                "description": "How categoryId matches. \"subtree\" (default) = that category AND all its subcategories, which is almost always what a person means. \"exact\" = only items filed directly on that category"
              },
              "currentHolderId": {
                "type": "string",
                "description": "Filter by current holder: a person resource id, or the literal \"me\" for the connected user"
              },
              "currentLocationId": {
                "type": "string",
                "description": "Filter by current location: a location resource id. Includes the whole subtree by default — see currentLocationMatch"
              },
              "currentLocationMatch": {
                "enum": [
                  "subtree",
                  "exact"
                ],
                "type": "string",
                "description": "How currentLocationId matches. \"subtree\" (default) = that place AND everything inside it, so a building returns its rooms' items. \"exact\" = only items sitting on that place itself"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string",
                "description": "Why an empty result is empty (e.g. no linked person for \"me\")"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Item id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Item name"
                    },
                    "status": {
                      "type": "string",
                      "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
                    },
                    "webUrl": {
                      "type": "string",
                      "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
                    },
                    "isDraft": {
                      "type": "boolean",
                      "description": "Present and true only for an unfinished draft capture"
                    },
                    "modelId": {
                      "type": "string",
                      "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
                    },
                    "category": {
                      "type": "string",
                      "description": "Category name"
                    },
                    "quantity": {
                      "type": "number",
                      "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
                    },
                    "container": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Container item id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Container item name"
                        }
                      },
                      "description": "The container this item is packed into, if any",
                      "additionalProperties": {}
                    },
                    "modelName": {
                      "type": "string",
                      "description": "The model's name"
                    },
                    "compartment": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Compartment id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Compartment name"
                        }
                      },
                      "description": "The compartment of that container the item sits in (absent = directly in the container)",
                      "additionalProperties": {}
                    },
                    "description": {
                      "type": "string",
                      "description": "Item description"
                    },
                    "primaryCode": {
                      "type": "string",
                      "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
                    },
                    "homeLocation": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Resource id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Resource name"
                        },
                        "archived": {
                          "type": "boolean",
                          "const": true,
                          "description": "The referenced resource is archived"
                        }
                      },
                      "description": "Where the item belongs",
                      "additionalProperties": {}
                    },
                    "trackingMode": {
                      "type": "string",
                      "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
                    },
                    "contentsCount": {
                      "type": "number",
                      "description": "Direct contents count — containers only"
                    },
                    "currentHolder": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Resource id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Resource name"
                        },
                        "archived": {
                          "type": "boolean",
                          "const": true,
                          "description": "The referenced resource is archived"
                        }
                      },
                      "description": "Person currently holding it",
                      "additionalProperties": {}
                    },
                    "currentLocation": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Resource id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Resource name"
                        },
                        "archived": {
                          "type": "boolean",
                          "const": true,
                          "description": "The referenced resource is archived"
                        }
                      },
                      "description": "Where the item is now",
                      "additionalProperties": {}
                    },
                    "effectiveHolder": {
                      "type": "string",
                      "description": "Holder followed through the container chain"
                    },
                    "effectiveLocation": {
                      "type": "string",
                      "description": "Location followed through the container chain"
                    },
                    "responsiblePerson": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Resource id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Resource name"
                        },
                        "archived": {
                          "type": "boolean",
                          "const": true,
                          "description": "The referenced resource is archived"
                        }
                      },
                      "description": "Person responsible",
                      "additionalProperties": {}
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The matching items"
              },
              "listUrl": {
                "type": "string",
                "description": "Link that opens this same result in the web app. Absent when the filter combination has no list-URL form, or when the deployment has no public address"
              },
              "matchedBy": {
                "type": "string",
                "description": "\"code\" when the query resolved as an exact asset code"
              },
              "truncated": {
                "type": "boolean",
                "description": "The server scan hit its cap — narrow the search"
              },
              "totalCount": {
                "type": "number",
                "description": "Total matches (a lower bound when `truncated` is true)"
              },
              "currencySums": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Field label as the org named it"
                    },
                    "total": {
                      "type": "number",
                      "description": "Sum over ALL matching rows"
                    },
                    "fieldDefId": {
                      "type": "string",
                      "description": "Field definition id"
                    },
                    "currencyCode": {
                      "type": "string",
                      "description": "ISO code, e.g. CHF"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Per-currency-field totals over EVERY matching row, not just this page — the answer to \"what is this worth\". Absent when the org has no currency field. A lower bound while `truncated` is true"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Search items",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "show_items",
          "title": "Show items",
          "description": "Show a set of inventory items as a visual picker: a photo list in which each row carries the item's name, the code printed on its asset tag, its condition and where it is. It suits a choice between items or a request to see them (\"which drill can I take?\", \"show me the beamers in the Aula\"), and items that share a name, which the photos, codes and rooms tell apart. `itemIds` are ids from search_items rows (up to 24, shown in the given order); `title` is an optional caption; `total` is the size of the full result when only part of it is shown (the card says \"Showing 8 of 40\"). Every row carries `photoUrl`, the item's main photo (absent when it has none); this tool and get_item are the only tools that return item photos, and get_item shows a single item. Display only: it writes nothing and does not search. Personal drafts are never shown. Hosts that render widgets draw the picker; other clients receive the same rows as text.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemIds"
            ],
            "properties": {
              "title": {
                "type": "string",
                "description": "Short caption naming the list, e.g. \"Beamers in Room 204\""
              },
              "total": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Total matches behind this selection when only some are shown; the card says \"Showing 8 of 40\""
              },
              "itemIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 24,
                "description": "Item ids from search_items rows, in display order (max 24)"
              }
            }
          },
          "annotations": {
            "title": "Show items",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "inventory_overview",
          "title": "Inventory overview",
          "description": "The shape of the whole inventory in one call: the category tree with an item count on every node (each count covers the node's whole subtree), `statusCounts` per condition (available | in_repair | defect | lost | retired), and `assignedToMe`, how many items the connected user holds, and the first few of them in `assignedItems`. It answers \"what do we own?\", \"how many X do we have?\" (the count on X's node, no paging through search_items) and \"what is broken?\". `myPersonId` is the person RECORD behind the connected login, which is what \"me\" means in search_items and assign_item. Every number is org-wide and counts published items only; the connected user's own unfinished captures are the separate `draftCount`. A categoryId from the tree is the search_items filter for the items behind a count.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "listUrl": {
                "type": "string",
                "description": "Link to the full item list in the web app"
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Category name"
                    },
                    "count": {
                      "type": "number",
                      "description": "Items in this category AND its whole subtree — the same set search_items returns for this categoryId"
                    },
                    "children": {
                      "type": "array",
                      "items": {},
                      "description": "Sub-categories, same shape (absent when there are none)"
                    },
                    "categoryId": {
                      "type": "string",
                      "description": "Category id"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The category tree, top level first, with a subtree count on every node"
              },
              "draftCount": {
                "type": "number",
                "description": "The connected user's own unreviewed captures (drafts are personal)"
              },
              "myPersonId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The person record behind the connected user's login account — what \"me\" resolves to in search_items and assign_item. null when no person is linked"
              },
              "totalItems": {
                "type": "number",
                "description": "Published items in the org"
              },
              "assignedToMe": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "How many items the connected user holds. null when no person is linked"
              },
              "statusCounts": {
                "description": "Item count per condition, keyed by status: available | in_repair | defect | lost | retired. This answers \"what's broken?\""
              },
              "assignedItems": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Item id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Item name"
                    },
                    "webUrl": {
                      "type": "string",
                      "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
                    },
                    "primaryCode": {
                      "type": "string",
                      "description": "Printed asset code"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The first few items the connected user holds (search_items with currentHolderId \"me\" lists all)"
              },
              "incompleteCount": {
                "type": "number",
                "description": "Items missing a required field"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Inventory overview",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_item",
          "title": "Get item",
          "description": "Get one inventory item by id: name, description, status, category and its four relations (home location, current location, current holder, responsible person) with resolved names, plus `photoUrl`, the item's main photo (absent when it has none). Hosts that render widgets draw the result as an item card; show_items draws several items. `status` is the item's CONDITION (available = not defect/lost/retired), so an available item may still be borrowed (`currentHolder`; check_item_availability has the full picture). Packed items (see pack_item) also carry `container` plus `effectiveLocation`/`effectiveHolder`, the position followed from the container while the item's own currentLocation/currentHolder are empty, and `compartment` { id, name } when they sit in one of the container's compartments (a named spot inside it, e.g. a vehicle's «GR4»; absent = directly in the container). Container items carry `holdsItems: true`, `compartments` [{ id, name }] in their order when they have any (the names pack_item's `compartment` takes), `contentsCount`, and `packedStock` when quantity-tracked stock sits inside them: [{ itemId, name, primaryCode?, quantity, compartmentName? }]. A quantity-tracked item whose units sit inside containers carries `packed`: one row per container and compartment { containerId, containerName, containerPath?, compartmentName?, quantity, effectiveLocationName?, effectiveHolderName? }; its `quantity` total counts them. This is the only tool that returns the item's custom field values (serial number, warranty, purchase price, whatever the organization defined): `customFields`, one entry per stored value with the org's own `label`, its `type`, the `value`, and `fieldDefId`, which joins it to the definitions get_item_requirements returns; a `date` value carries `valueIso`, the plain calendar day, and a `currency` value its `currencyCode` (absent = CHF). Values the connected user may not see are absent, not redacted. Drafts (unreviewed captures) are personal: another user's draft is not found even by id (standard not-found) until it is published.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id"
              }
            }
          },
          "annotations": {
            "title": "Get item",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "check_item_availability",
          "title": "Check item availability",
          "description": "Check whether an item is currently available: status, who holds it, where it is, how many tickets are open on it, how many of its maintenance checks are overdue and how many active orders request it. Status defect or in_repair, an open ticket other than a maintenance check that is not yet due, overdueMaintenance > 0 or requestedInOrders > 0 each make assign_item answer requiresAcknowledgment when it sets a holder. For quantity-tracked items the result also carries totalQuantity and distribution: one row per stocked level, locations AND people holding stock, with { locationId, name, kind: location|person, quantity, available, reserved?, minStock?, isLow? }, the same row shape transfer_stock and adjust_stock return after a write. available = quantity minus what active orders reserved, floored at 0; isLow compares AVAILABLE against that level's threshold, so a full shelf with heavy reservations IS low. minStock and isLow appear together and only where a threshold exists: an absent isLow means no threshold is set there, not that the level is healthy. reserved is absent when 0; person rows carry neither (orders deliver to places, and person-held stock cannot carry a threshold). locationId is the id adjust_stock, set_min_stock and transfer_stock take. Units inside containers (a bag, a vehicle compartment) are not in distribution: they come under packed, one row per container and compartment { containerId, containerName, containerPath?, compartmentName?, quantity, effectiveLocationName?, effectiveHolderName? } (absent when none), and totalQuantity counts them. Packed units are moved in the app's stock section; transfer_stock and adjust_stock work on places and people only.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "packed": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "quantity": {
                      "type": "number",
                      "description": "Units inside this container"
                    },
                    "containerId": {
                      "type": "string",
                      "description": "Item id of the container holding these units"
                    },
                    "containerName": {
                      "type": "string",
                      "description": "Container name"
                    },
                    "containerPath": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Names of the containers this container sits in, outermost first, each followed by the compartment the next one sits in (absent when none)"
                    },
                    "compartmentName": {
                      "type": "string",
                      "description": "The compartment of the container these units sit in (absent = directly in the container)"
                    },
                    "effectiveHolderName": {
                      "type": "string",
                      "description": "Who has the container now, followed through its containers"
                    },
                    "effectiveLocationName": {
                      "type": "string",
                      "description": "Where the container is now, followed through its containers"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Units inside containers (a bag, a vehicle compartment) — quantity-tracked items only, absent when none. Not in distribution; their place follows the container"
              },
              "status": {
                "type": "string",
                "description": "Condition (see search_items)"
              },
              "available": {
                "type": "boolean",
                "description": "Status available AND nobody currently holds it"
              },
              "openTickets": {
                "type": "number",
                "description": "Open tickets on this item"
              },
              "distribution": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "\"location\" or \"person\" (a person holding pool stock)"
                    },
                    "name": {
                      "type": "string",
                      "description": "Location or person name"
                    },
                    "isLow": {
                      "type": "boolean",
                      "description": "True when available < minStock. Present only alongside minStock — absent means no threshold is set here, NOT that the level is healthy"
                    },
                    "minStock": {
                      "type": "number",
                      "description": "Restock threshold here (absent when none is set)"
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Physical stock on hand here"
                    },
                    "reserved": {
                      "type": "number",
                      "description": "Of that, promised to active orders (absent when 0)"
                    },
                    "available": {
                      "type": "number",
                      "description": "Freely usable stock: quantity minus reserved, floored at 0. Always present"
                    },
                    "locationId": {
                      "type": "string",
                      "description": "Resource id of this place — pass it straight to adjust_stock, set_min_stock or transfer_stock (no search_resources round-trip needed)"
                    },
                    "locationName": {
                      "type": "string",
                      "description": "DEPRECATED — the same string as `name`, kept only for clients whose tool list froze before the rename"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Per-holder stock — quantity-tracked items only. One row per stocked level, locations AND people, each carrying its resource id so no search_resources lookup is needed."
              },
              "totalQuantity": {
                "type": "number",
                "description": "Pool total — quantity-tracked items only. Counts places, people AND units inside containers"
              },
              "currentHolderName": {
                "type": "string",
                "description": "Who holds it now"
              },
              "requestedInOrders": {
                "type": "number",
                "description": "Active orders that requested this item but have not picked it"
              },
              "overdueMaintenance": {
                "type": "number",
                "description": "Overdue maintenance checks; with any, assign_item answers requiresAcknowledgment when it sets a holder"
              },
              "currentLocationName": {
                "type": "string",
                "description": "Where it is now"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Check item availability",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "search_resources",
          "title": "Search people & locations",
          "description": "Find the resource id of ONE person or ONE location by name. `type` is required (\"person\" or \"location\"); returns the 10 best matches; name search only (no code or id lookup), and an empty query returns nothing. These ids are what assign_item, adjust_stock, transfer_stock, set_min_stock, create_order (deliverToResourceId), create_item (homeLocationId) and create_location / create_person (parent) take. A \"person\" here is a PERSON RECORD (someone items can be assigned to), NOT a login account; member userIds come from list_members. Every row carries `path`, the ancestor names root to parent (\"Schulhaus B\" → \"1. Obergeschoss\" for a room, a department chain for a person), and `parentId`; when several locations share a name, the path tells them apart. An empty result [] means no match. list_resources returns both whole trees without a name.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "type",
              "query"
            ],
            "properties": {
              "type": {
                "enum": [
                  "person",
                  "location"
                ],
                "type": "string"
              },
              "query": {
                "type": "string",
                "description": "Name to search for"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "result": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Resource id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Resource name"
                    },
                    "path": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Ancestor NAMES, root→parent (e.g. [\"Schulhaus B\", \"1. Obergeschoss\"]); empty at the top level. When several rows share a name, this is what tells them apart"
                    },
                    "parentId": {
                      "type": "string",
                      "description": "The parent resource's id (absent at the top level) — what create_location / create_person take as `parentId`"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Up to 10 best name matches; empty array means no match"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Search people & locations",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_resources",
          "title": "Browse locations & people",
          "description": "The organization's PLACES and PEOPLE in one call, the structural twin of inventory_overview: \"what rooms do we have?\", \"who is in the organization?\", \"what is in the Schulhaus Dorf?\". Returns `locations` and `people` as NESTED trees (buildings → floors → rooms; departments → people), each node carrying `id`, `name` and `count`. A node id is the search_items filter for the items behind a count: currentLocationId for a place, currentHolderId for a person; the two match exactly. A LOCATION's count covers its whole subtree (a building counts its rooms' items, as search_items does by default); a PERSON's count is what that one person holds, since currentHolderId matches one person and never a subtree. Person nodes also carry `email`, `hasAccount` (the record is linked to a login account; member userIds come from list_members) and `isMe` for the connected user's own record. `assignable: false` marks a record items cannot be assigned to; search_resources never returns those. `type` limits the answer to one tree. `truncated: true` means the organization is bigger than one bounded pass, and the counts are lower bounds.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "type": {
                "enum": [
                  "person",
                  "location"
                ],
                "type": "string",
                "description": "Only this tree; absent = both"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "people": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Person resource id"
                    },
                    "isMe": {
                      "type": "boolean",
                      "description": "Present only as true: the connected user's own person record — what \"me\" resolves to"
                    },
                    "name": {
                      "type": "string",
                      "description": "Person name"
                    },
                    "count": {
                      "type": "number",
                      "description": "Items THIS person currently holds — the same set search_items returns for this id as currentHolderId. Unlike the location tree this does NOT roll up: currentHolderId matches one person, never a subtree"
                    },
                    "email": {
                      "type": "string",
                      "description": "Email, when one is recorded"
                    },
                    "children": {
                      "type": "array",
                      "items": {},
                      "description": "People below this one, same shape"
                    },
                    "assignable": {
                      "type": "boolean",
                      "description": "Present only as false: items cannot be assigned to this person"
                    },
                    "hasAccount": {
                      "type": "boolean",
                      "description": "Present only as true: this person record is linked to a login account. Member userIds still come from list_members"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The people tree, top level first — departments → people"
              },
              "locations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Location resource id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Location name"
                    },
                    "count": {
                      "type": "number",
                      "description": "Items currently in this location AND its whole subtree — the same set search_items returns for this id as currentLocationId"
                    },
                    "children": {
                      "type": "array",
                      "items": {},
                      "description": "Sub-locations, same shape (absent when there are none)"
                    },
                    "assignable": {
                      "type": "boolean",
                      "description": "Present only as false: items cannot be assigned here (search_resources never returns these)"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The location tree, top level first — buildings → floors → rooms"
              },
              "truncated": {
                "type": "boolean",
                "description": "A bounded read hit its cap — treat the counts as lower bounds and the tree as possibly incomplete"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Browse locations & people",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_item_requirements",
          "title": "Get item creation requirements",
          "description": "Get what creating an inventory item needs. Without arguments: the organization's category tree plus the required fields that apply to ALL items. With categoryId: that category's full field list (required and optional, with types and select options); the fieldDefIds are the keys of customFields in create_item and preview_item_create. A category is required for every item except a draft (isDraft: true). The server checks that a category exists, not that it fits the item: an item filed under an unfitting category shows there for everyone. create_category adds a new category.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "categoryId": {
                "type": "string",
                "description": "Category id (from the no-argument call) to get that category's full field list"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string",
                "description": "Note on category fit: the server checks that a category exists, not that it fits"
              },
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "Field type: text | number | date | select | multiselect | …"
                    },
                    "label": {
                      "type": "string",
                      "description": "Field label as the org named it"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Allowed values for selects"
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether a value is mandatory"
                    },
                    "fieldDefId": {
                      "type": "string",
                      "description": "Field definition id"
                    },
                    "currencyCode": {
                      "type": "string",
                      "description": "ISO code of a currency field when it is not CHF (absent = CHF)"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "All applicable fields, required and optional — categoryId mode"
              },
              "builtIn": {
                "description": "Built-in create_item facts (name, category, homeLocation, quantity)"
              },
              "category": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Category id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Category name"
                  }
                },
                "description": "The resolved category — categoryId mode",
                "additionalProperties": {}
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Category id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Category name"
                    },
                    "parentId": {
                      "type": "string",
                      "description": "Parent category id"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The whole category tree — only in the no-argument mode"
              },
              "orgWideFields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "Field type: text | number | date | select | multiselect | …"
                    },
                    "label": {
                      "type": "string",
                      "description": "Field label as the org named it"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Allowed values for selects"
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether a value is mandatory"
                    },
                    "fieldDefId": {
                      "type": "string",
                      "description": "Field definition id"
                    },
                    "currencyCode": {
                      "type": "string",
                      "description": "ISO code of a currency field when it is not CHF (absent = CHF)"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Required fields EVERY item needs — no-argument mode"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Get item creation requirements",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "preview_item_create",
          "title": "Preview item creation",
          "description": "Preview an item creation without writing anything (read-only). It takes create_item's arguments, all optional: partial values are valid. Returns the resolved proposal, the applicable field definitions and the required fields still missing (`missingRequired`); without a categoryId it adds `missingCategory` and the category list. In hosts that render widgets (e.g. ChatGPT) the result is an editable confirm card: missing values are filled and a category is picked on the card, and its 'Create item' button calls create_item itself. Hosts without widgets receive the same proposal as data.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Proposed item name; the card asks for it when absent"
              },
              "minStock": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Optional restock threshold for quantity-tracked stock"
              },
              "quantity": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Initial stock amount — required with trackingMode \"quantity\""
              },
              "categoryId": {
                "type": "string",
                "description": "Category id (from get_item_requirements); without it the card shows a category picker"
              },
              "description": {
                "type": "string"
              },
              "customFields": {
                "type": "object",
                "description": "Proposed field values keyed by fieldDefId (from get_item_requirements) — same shape as create_item's customFields",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  ]
                }
              },
              "trackingMode": {
                "enum": [
                  "quantity"
                ],
                "type": "string",
                "description": "\"quantity\" for quantity-tracked stock (consumables) instead of a serialized single item"
              },
              "homeLocationId": {
                "type": "string",
                "description": "Home location resource id (from search_resources); absent = the category or organization default"
              },
              "responsiblePersonId": {
                "type": "string",
                "description": "Responsible person resource id (optional)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "v",
              "mode",
              "proposal",
              "fields",
              "missingRequired"
            ],
            "properties": {
              "v": {
                "type": "number"
              },
              "mode": {
                "type": "string",
                "const": "confirmCreate"
              },
              "debug": {
                "type": "boolean"
              },
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "fieldDefId",
                    "label",
                    "type"
                  ],
                  "properties": {
                    "type": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "required": {
                      "type": "boolean"
                    },
                    "fieldDefId": {
                      "type": "string"
                    },
                    "currencyCode": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "proposal": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "minStock": {
                    "type": "number"
                  },
                  "quantity": {
                    "type": "number"
                  },
                  "categoryId": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "categoryName": {
                    "type": "string"
                  },
                  "customFields": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    }
                  },
                  "trackingMode": {
                    "enum": [
                      "quantity"
                    ],
                    "type": "string"
                  },
                  "homeLocationId": {
                    "type": "string"
                  },
                  "homeLocationName": {
                    "type": "string"
                  },
                  "responsiblePersonId": {
                    "type": "string"
                  },
                  "responsiblePersonName": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "name"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "parentId": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "autoConfirm": {
                "type": "boolean"
              },
              "missingCategory": {
                "type": "boolean"
              },
              "missingRequired": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Preview item creation",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "create_item",
          "title": "Create item",
          "description": "Create an inventory item. Requires the manager role. A category is required unless isDraft is true: a call without categoryId returns { missingCategory, categories } and writes nothing. The server checks that the category exists, not that it fits the item. Required fields per category come from get_item_requirements; when some are missing the call returns { missingFields } and creates nothing, and the same call with those values in customFields (keys = fieldDefId) creates the item. isDraft: true saves an incomplete draft without the required-field and category checks, which the user finishes in the app. At the organization's item allowance the call returns { itemLimitReached } and creates nothing; drafts do not count against the allowance and can still be saved at it. For quantity-tracked stock (consumables like paper or markers) pass trackingMode \"quantity\" with quantity and an optional minStock. With clientRequestId a repeated call returns the existing item instead of a duplicate; without it every call creates a new item. preview_item_create renders the same proposal as an editable confirm card in widget hosts; its button calls this tool.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Item name (required)"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Save as an incomplete draft (skips the required-fields check; the user finishes it in the app)"
              },
              "minStock": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Optional restock threshold for quantity-tracked stock"
              },
              "quantity": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Initial stock amount — required with trackingMode \"quantity\""
              },
              "categoryId": {
                "type": "string",
                "description": "Category id (from get_item_requirements); required unless isDraft is true"
              },
              "description": {
                "type": "string"
              },
              "customFields": {
                "type": "object",
                "description": "Field values keyed by fieldDefId (from get_item_requirements). Dates as a plain calendar day \"YYYY-MM-DD\" (a full timestamp works too, but only WITH an explicit offset — this server has no timezone and does no conversion), selects as one of the listed options, multiselect as an ARRAY of option strings, currency as a plain number in the field's own currency (see its currencyCode; default CHF), url as a full http(s) link (protocol added when missing).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  ]
                }
              },
              "trackingMode": {
                "enum": [
                  "quantity"
                ],
                "type": "string",
                "description": "\"quantity\" for quantity-tracked stock (consumables) instead of a serialized single item"
              },
              "homeLocationId": {
                "type": "string",
                "description": "Home location resource id (from search_resources); absent = the category or organization default"
              },
              "clientRequestId": {
                "type": "string",
                "description": "A unique id for this creation (e.g. a UUID). A repeated call with the SAME id returns the existing item instead of creating a duplicate; a new id creates a new item."
              },
              "responsiblePersonId": {
                "type": "string",
                "description": "Responsible person resource id (optional)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Item id"
              },
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "usage": {
                "type": "number",
                "description": "Tracked items the organization has, with itemLimitReached"
              },
              "status": {
                "type": "string",
                "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Present and true only for an unfinished draft capture"
              },
              "modelId": {
                "type": "string",
                "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
              },
              "category": {
                "type": "string",
                "description": "Category name"
              },
              "quantity": {
                "type": "number",
                "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
              },
              "allowance": {
                "type": "number",
                "description": "Items the organization's package includes, with itemLimitReached"
              },
              "container": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Container item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Container item name"
                  }
                },
                "description": "The container this item is packed into, if any",
                "additionalProperties": {}
              },
              "modelName": {
                "type": "string",
                "description": "The model's name"
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Category id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Category name"
                    },
                    "parentId": {
                      "type": "string",
                      "description": "Parent category id, if any"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The organization's category tree, sent with a missingCategory round so the retry costs one call. Empty means the org has no categories yet"
              },
              "compartment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Compartment id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Compartment name"
                  }
                },
                "description": "The compartment of that container the item sits in (absent = directly in the container)",
                "additionalProperties": {}
              },
              "description": {
                "type": "string",
                "description": "Item description"
              },
              "instruction": {
                "type": "string",
                "description": "Explanation of a round that wrote nothing (missing fields, missing category, allowance reached)"
              },
              "primaryCode": {
                "type": "string",
                "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
              },
              "homeLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item belongs",
                "additionalProperties": {}
              },
              "trackingMode": {
                "type": "string",
                "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
              },
              "contentsCount": {
                "type": "number",
                "description": "Direct contents count — containers only"
              },
              "currentHolder": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person currently holding it",
                "additionalProperties": {}
              },
              "missingFields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "Field type: text | number | date | select | multiselect | …"
                    },
                    "label": {
                      "type": "string",
                      "description": "Field label as the org named it"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Allowed values for selects"
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether a value is mandatory"
                    },
                    "fieldDefId": {
                      "type": "string",
                      "description": "Field definition id"
                    },
                    "currencyCode": {
                      "type": "string",
                      "description": "ISO code of a currency field when it is not CHF (absent = CHF)"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Present INSTEAD of the item when required values are missing: nothing was created; the same call with these values in customFields creates it"
              },
              "currentLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item is now",
                "additionalProperties": {}
              },
              "effectiveHolder": {
                "type": "string",
                "description": "Holder followed through the container chain"
              },
              "missingCategory": {
                "type": "boolean",
                "description": "Present and true when the call carried no categoryId — nothing was created; every item except a draft needs a category"
              },
              "itemLimitReached": {
                "type": "boolean",
                "description": "Present and true when the organization is at its included item allowance — nothing was created and no retry of this call will succeed"
              },
              "effectiveLocation": {
                "type": "string",
                "description": "Location followed through the container chain"
              },
              "responsiblePerson": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person responsible",
                "additionalProperties": {}
              },
              "missingFieldLabels": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Labels a saved DRAFT still needs before it can be published — the user finishes them in the app"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create item",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "assign_item",
          "title": "Assign / move item",
          "description": "Assign or move an item: set its current location, current holder, responsible person or home location. An omitted field stays unchanged; null clears the current location or the current holder. The home location and the responsible person can never be cleared (every item has both); the literal \"default\" for responsiblePersonId removes the override, and the item follows its category's or the organization's default again. Both PERSON fields take the literal \"me\" for the connected user's own person record (the same shorthand as in search_items). Returns the updated item. Setting a holder on an item with open tickets, overdue maintenance or the status defect or in_repair writes nothing and returns { requiresAcknowledgment: true, warnings } (warnings.itemStatus names the status); the same call with acknowledgeWarnings: true performs it. Setting a holder on an item that an active order requests (not yet picked) returns { requiresAcknowledgment: true, requested }; the same call with acknowledgeRequested: true performs it. Setting a current location or holder on a packed item unpacks it first. Requires the manager role: a member cannot assign anything, not even to themselves with \"me\". Idempotent: unchanged values change nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "homeLocationId": {
                "type": "string",
                "description": "Location resource id (cannot be cleared)"
              },
              "currentHolderId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Person resource id who borrows the item, the literal \"me\" for the connected user, or null to clear"
              },
              "currentLocationId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Location resource id, or null to clear"
              },
              "acknowledgeWarnings": {
                "type": "boolean",
                "description": "true performs the call despite the warnings a previous requiresAcknowledgment result named"
              },
              "responsiblePersonId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Person resource id, the literal \"me\" for the connected user, or the literal \"default\" to hand the item back to the category/organization default chain. It cannot be cleared"
              },
              "acknowledgeRequested": {
                "type": "boolean",
                "description": "true performs the assignment despite the active order requests a previous requiresAcknowledgment result named"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Item id"
              },
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "status": {
                "type": "string",
                "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Present and true only for an unfinished draft capture"
              },
              "modelId": {
                "type": "string",
                "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
              },
              "category": {
                "type": "string",
                "description": "Category name"
              },
              "quantity": {
                "type": "number",
                "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
              },
              "warnings": {
                "description": "Open tickets / overdue maintenance behind a requires-ack round"
              },
              "container": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Container item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Container item name"
                  }
                },
                "description": "The container this item is packed into, if any",
                "additionalProperties": {}
              },
              "modelName": {
                "type": "string",
                "description": "The model's name"
              },
              "requested": {
                "description": "The active orders that requested this item (.orders names them)"
              },
              "compartment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Compartment id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Compartment name"
                  }
                },
                "description": "The compartment of that container the item sits in (absent = directly in the container)",
                "additionalProperties": {}
              },
              "description": {
                "type": "string",
                "description": "Item description"
              },
              "instruction": {
                "type": "string",
                "description": "Which acknowledge flag performs the call"
              },
              "primaryCode": {
                "type": "string",
                "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
              },
              "homeLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item belongs",
                "additionalProperties": {}
              },
              "trackingMode": {
                "type": "string",
                "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
              },
              "contentsCount": {
                "type": "number",
                "description": "Direct contents count — containers only"
              },
              "currentHolder": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person currently holding it",
                "additionalProperties": {}
              },
              "currentLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item is now",
                "additionalProperties": {}
              },
              "effectiveHolder": {
                "type": "string",
                "description": "Holder followed through the container chain"
              },
              "effectiveLocation": {
                "type": "string",
                "description": "Location followed through the container chain"
              },
              "responsiblePerson": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person responsible",
                "additionalProperties": {}
              },
              "requiresAcknowledgment": {
                "type": "boolean",
                "description": "Present and true when nothing was written because of what this result names; the SAME call with the acknowledge flag named in `instruction` performs it"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Assign / move item",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "pack_item",
          "title": "Pack item into container",
          "description": "Pack an item into a container: a case, cart, box or vehicle that is itself an inventory item (e.g. the voltmeter into the experiment case). While packed, the item's location and holder FOLLOW the container: one assign_item call on the container moves or lends the whole kit, and item reads show the followed position as effectiveLocation/effectiveHolder. A container can have named compartments (a vehicle's «Fahrerhaus», «GR1»…«GR7»; get_item on the container lists them as `compartments`): `compartment` takes a name (case-insensitive) or an id; an unknown name is refused with `unknownCompartment` and the container's `validNames`. `compartment: null` puts the item directly in the container, outside any compartment (also from a compartment of the same container). Without `compartment`, re-packing into the same container keeps the item's compartment, and packing into another container puts it directly in it. Packing clears the item's own current location and holder, so an item someone holds is taken from them. Both sides must be serialized items in this organization: quantity-tracked stock goes into a container from the item's stock section in the app (it reads back as `packed` on get_item / check_item_availability). Containers nest up to three levels (compartments are not a level). Refused: lost/retired items, items reserved for an active order (also a container that holds such an item, since packing moves its contents too) and containers switched to «cannot hold items». Requires the manager role. Idempotent: re-packing into the same container and compartment changes nothing. unpack_item reverses it.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId",
              "containerId"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id to pack"
              },
              "compartment": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Compartment of the container, by name (case-insensitive) or id; null = directly in the container, outside any compartment. Absent = the current compartment (same container) or directly in another container"
              },
              "containerId": {
                "type": "string",
                "description": "Item id of the container to pack it into"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Item id"
              },
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "status": {
                "type": "string",
                "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Present and true only for an unfinished draft capture"
              },
              "modelId": {
                "type": "string",
                "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
              },
              "category": {
                "type": "string",
                "description": "Category name"
              },
              "quantity": {
                "type": "number",
                "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
              },
              "container": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Container item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Container item name"
                  }
                },
                "description": "The container this item is packed into, if any",
                "additionalProperties": {}
              },
              "modelName": {
                "type": "string",
                "description": "The model's name"
              },
              "compartment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Compartment id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Compartment name"
                  }
                },
                "description": "The compartment of that container the item sits in (absent = directly in the container)",
                "additionalProperties": {}
              },
              "description": {
                "type": "string",
                "description": "Item description"
              },
              "primaryCode": {
                "type": "string",
                "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
              },
              "homeLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item belongs",
                "additionalProperties": {}
              },
              "trackingMode": {
                "type": "string",
                "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
              },
              "contentsCount": {
                "type": "number",
                "description": "Direct contents count — containers only"
              },
              "currentHolder": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person currently holding it",
                "additionalProperties": {}
              },
              "currentLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item is now",
                "additionalProperties": {}
              },
              "effectiveHolder": {
                "type": "string",
                "description": "Holder followed through the container chain"
              },
              "effectiveLocation": {
                "type": "string",
                "description": "Location followed through the container chain"
              },
              "responsiblePerson": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person responsible",
                "additionalProperties": {}
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Pack item into container",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "unpack_item",
          "title": "Unpack item from container",
          "description": "Take an item out of its container. Its current location and holder are set from the container's effective position at that moment (a snapshot: it stops following the container). No change if the item is not packed. Setting a current location or holder on a packed item with assign_item unpacks it first, in the same call. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Item id"
              },
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "status": {
                "type": "string",
                "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Present and true only for an unfinished draft capture"
              },
              "modelId": {
                "type": "string",
                "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
              },
              "category": {
                "type": "string",
                "description": "Category name"
              },
              "quantity": {
                "type": "number",
                "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
              },
              "container": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Container item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Container item name"
                  }
                },
                "description": "The container this item is packed into, if any",
                "additionalProperties": {}
              },
              "modelName": {
                "type": "string",
                "description": "The model's name"
              },
              "compartment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Compartment id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Compartment name"
                  }
                },
                "description": "The compartment of that container the item sits in (absent = directly in the container)",
                "additionalProperties": {}
              },
              "description": {
                "type": "string",
                "description": "Item description"
              },
              "primaryCode": {
                "type": "string",
                "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
              },
              "homeLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item belongs",
                "additionalProperties": {}
              },
              "trackingMode": {
                "type": "string",
                "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
              },
              "contentsCount": {
                "type": "number",
                "description": "Direct contents count — containers only"
              },
              "currentHolder": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person currently holding it",
                "additionalProperties": {}
              },
              "currentLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item is now",
                "additionalProperties": {}
              },
              "effectiveHolder": {
                "type": "string",
                "description": "Holder followed through the container chain"
              },
              "effectiveLocation": {
                "type": "string",
                "description": "Location followed through the container chain"
              },
              "responsiblePerson": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person responsible",
                "additionalProperties": {}
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Unpack item from container",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "transfer_stock",
          "title": "Transfer stock",
          "description": "Move an amount of a quantity-tracked item's stock from one place or person to another (e.g. 3 packs of printer paper from the storeroom to room 201, or 5 markers to a teacher). Quantity-tracked items only; assign_item moves serialized items. Location and person ids come from search_resources or from check_item_availability's distribution. Returns every stocked level after the move as distribution: { locationId, name, kind: location|person, quantity, available, reserved?, minStock?, isLow? }, the same row shape check_item_availability returns, so isLow shows whether either end is now low (isLow counts AVAILABLE stock: on hand minus what orders reserved). Amounts reserved for orders or exceeding the source location's stock are rejected. When the item has overdue maintenance the call writes nothing and returns { requiresAcknowledgment: true, warnings }; the same call with acknowledgeWarnings: true performs it. Requires the manager role. Not idempotent: a repeated call moves the stock again.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId",
              "fromLocationId",
              "toLocationId",
              "amount"
            ],
            "properties": {
              "amount": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "How many units to move (integer, at least 1)"
              },
              "itemId": {
                "type": "string",
                "description": "Item id (must be a quantity-tracked item)"
              },
              "toLocationId": {
                "type": "string",
                "description": "Destination location or person resource id"
              },
              "fromLocationId": {
                "type": "string",
                "description": "Source location or person resource id (where the stock is now)"
              },
              "acknowledgeWarnings": {
                "type": "boolean",
                "description": "true performs the call despite the warnings a previous requiresAcknowledgment result named"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "warnings": {
                "description": "Overdue maintenance behind a requires-ack round"
              },
              "instruction": {
                "type": "string",
                "description": "Which acknowledge flag performs the call"
              },
              "distribution": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "\"location\" or \"person\" (a person holding pool stock)"
                    },
                    "name": {
                      "type": "string",
                      "description": "Location or person name"
                    },
                    "isLow": {
                      "type": "boolean",
                      "description": "True when available < minStock. Present only alongside minStock — absent means no threshold is set here, NOT that the level is healthy"
                    },
                    "minStock": {
                      "type": "number",
                      "description": "Restock threshold here (absent when none is set)"
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Physical stock on hand here"
                    },
                    "reserved": {
                      "type": "number",
                      "description": "Of that, promised to active orders (absent when 0)"
                    },
                    "available": {
                      "type": "number",
                      "description": "Freely usable stock: quantity minus reserved, floored at 0. Always present"
                    },
                    "locationId": {
                      "type": "string",
                      "description": "Resource id of this place — pass it straight to adjust_stock, set_min_stock or transfer_stock (no search_resources round-trip needed)"
                    },
                    "locationName": {
                      "type": "string",
                      "description": "DEPRECATED — the same string as `name`, kept only for clients whose tool list froze before the rename"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Every stocked level after the move — the SAME row shape check_item_availability returns"
              },
              "totalQuantity": {
                "type": "number",
                "description": "Pool total after the move"
              },
              "requiresAcknowledgment": {
                "type": "boolean",
                "description": "Present and true when nothing was written because of what this result names; the SAME call with the acknowledge flag named in `instruction` performs it"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Transfer stock",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "create_ticket",
          "title": "Create ticket",
          "description": "Create a defect or maintenance ticket on an item. The organization's default assignee rules apply, and the assignee is emailed straight away. setItemStatus also sets the item's condition in the same call (like the web report form, where a defect report usually marks the item \"defect\"); members may use it, unlike set_item_status. With clientRequestId a repeated call returns the existing ticket instead of a duplicate; without it every call creates a new ticket. Quantity-tracked items take no tickets (refused with quantityItem).",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId",
              "type",
              "title"
            ],
            "properties": {
              "type": {
                "enum": [
                  "defect",
                  "maintenance"
                ],
                "type": "string"
              },
              "title": {
                "type": "string",
                "description": "Short ticket title"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "priority": {
                "enum": [
                  "low",
                  "normal",
                  "high"
                ],
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "setItemStatus": {
                "enum": [
                  "defect",
                  "in_repair"
                ],
                "type": "string",
                "description": "Also set the item's condition in the same operation; absent = the item status stays unchanged. set_item_status covers the other status changes."
              },
              "clientRequestId": {
                "type": "string",
                "description": "A unique id for this request (e.g. a UUID). A repeated call with the SAME id returns the existing ticket instead of creating a duplicate; a new id creates a new ticket."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "title": {
                "type": "string",
                "description": "Ticket title"
              },
              "status": {
                "type": "string",
                "description": "Ticket status"
              },
              "ticketId": {
                "type": "string",
                "description": "The new ticket's id"
              },
              "assigneeName": {
                "type": "string",
                "description": "Who it was routed to"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create ticket",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_tickets",
          "title": "List tickets",
          "description": "List defect and maintenance tickets, newest first, capped at about 500 (`truncated` when cut; filters narrow it). Filters: itemId, statuses (open, in_progress, done, wontfix; \"open tickets\" usually means open + in_progress), type, and a text search over title and description. Every row carries `createdAt` (when the problem was reported, the sort key) and `reporterName` (absent when nobody reported it: a maintenance plan created it, or it came from a logged-out QR report). Dates come twice, the epoch and its ISO twin: `createdAtIso` / `closedAtIso` are UTC instants, `dueAtIso` is a plain calendar day; the server does no timezone conversion. A ticket has no printed code: `webUrl` is its page in the web app and `id` the handle for update_ticket, add_comment and list_comments. The rows are the tickets the connected user sees in the app.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "type": {
                "enum": [
                  "defect",
                  "maintenance",
                  "inspection",
                  "other"
                ],
                "type": "string"
              },
              "itemId": {
                "type": "string",
                "description": "Only tickets on this item"
              },
              "search": {
                "type": "string",
                "description": "Text search over ticket title and description"
              },
              "statuses": {
                "type": "array",
                "items": {
                  "enum": [
                    "open",
                    "in_progress",
                    "done",
                    "wontfix"
                  ],
                  "type": "string"
                },
                "description": "Only these statuses — \"open tickets\" usually means [\"open\", \"in_progress\"]"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "tickets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Ticket id"
                    },
                    "type": {
                      "type": "string",
                      "description": "Ticket type: defect | maintenance | …"
                    },
                    "dueAt": {
                      "type": "number",
                      "description": "Due date, epoch milliseconds"
                    },
                    "title": {
                      "type": "string",
                      "description": "Ticket title"
                    },
                    "status": {
                      "type": "string",
                      "description": "Ticket status: open | in_progress | done | wontfix"
                    },
                    "webUrl": {
                      "type": "string",
                      "description": "Link to this ticket in the web app, for a person to open; `id` is the handle for tool calls. Absent when the deployment has no public address"
                    },
                    "closedAt": {
                      "type": "number",
                      "description": "Close time, epoch milliseconds"
                    },
                    "dueAtIso": {
                      "type": "string",
                      "description": "The due date as a plain calendar day, \"YYYY-MM-DD\". A DAY, not a moment: the server does no timezone conversion"
                    },
                    "itemName": {
                      "type": "string",
                      "description": "The item the ticket is about"
                    },
                    "priority": {
                      "type": "string",
                      "description": "low | normal | high"
                    },
                    "createdAt": {
                      "type": "number",
                      "description": "When the ticket was reported, epoch milliseconds — the \"since when is it broken?\" answer, and what \"newest first\" sorts on"
                    },
                    "closedAtIso": {
                      "type": "string",
                      "description": "The same moment as an ISO-8601 UTC timestamp"
                    },
                    "primaryCode": {
                      "type": "string",
                      "description": "The item's printed asset code"
                    },
                    "assigneeName": {
                      "type": "string",
                      "description": "Who it is assigned to"
                    },
                    "createdAtIso": {
                      "type": "string",
                      "description": "The same moment as an ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
                    },
                    "reporterName": {
                      "type": "string",
                      "description": "Who reported it. Absent when nobody did — a maintenance plan minted the ticket, or it came from a logged-out QR report"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The matching tickets"
              },
              "truncated": {
                "type": "boolean",
                "description": "The scan hit its cap — narrow the filters"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List tickets",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_ticket",
          "title": "Update ticket",
          "description": "Update a ticket: change its status (open, in_progress, done, wontfix) and/or edit title, description, priority or due date. Closing = status done (resolved) or wontfix (will not be handled); restoreItemStatus: true on a close also sets the item back to \"available\" (typical after a repair). The due date is `dueDate`, a calendar day (\"2026-08-11\"); the legacy `dueAt` epoch still works; exactly one of the two, and null on either clears the date. Status and due-date changes appear in the ticket's timeline under the connected user's name. Only the reporter, the assignee (or a member of the assigned team) or a ticket manager (responsibleForTickets) can update it; viewers never can. Ticket ids come from list_tickets. Returns the updated ticket in the list_tickets row shape (`createdAt`, `reporterName`, `webUrl` and the ISO date twins included). Idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "ticketId"
            ],
            "properties": {
              "dueAt": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Due date as epoch milliseconds at UTC midnight of the day, or null to clear (legacy form of `dueDate`; exactly one of the two)"
              },
              "title": {
                "type": "string"
              },
              "status": {
                "enum": [
                  "open",
                  "in_progress",
                  "done",
                  "wontfix"
                ],
                "type": "string",
                "description": "New status — done = resolved, wontfix = closed without handling"
              },
              "dueDate": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Due date as a calendar day, \"YYYY-MM-DD\" (e.g. \"2026-08-11\"), or null to clear. A full timestamp is accepted only WITH an explicit offset (\"2026-08-11T00:00:00+02:00\"), and the server takes the calendar day as seen in that offset; it does no timezone conversion of its own, so an offset-less timestamp is refused. Passing both dueAt and dueDate is an error"
              },
              "priority": {
                "anyOf": [
                  {
                    "enum": [
                      "low",
                      "normal",
                      "high"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "New priority, or null to clear"
              },
              "ticketId": {
                "type": "string",
                "description": "Ticket id (from list_tickets)"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "New description, or null to clear"
              },
              "restoreItemStatus": {
                "type": "boolean",
                "description": "When closing: also set the item back to \"available\" (typical after a repair)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Ticket id"
              },
              "type": {
                "type": "string",
                "description": "Ticket type: defect | maintenance | …"
              },
              "dueAt": {
                "type": "number",
                "description": "Due date, epoch milliseconds"
              },
              "title": {
                "type": "string",
                "description": "Ticket title"
              },
              "status": {
                "type": "string",
                "description": "Ticket status: open | in_progress | done | wontfix"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this ticket in the web app, for a person to open; `id` is the handle for tool calls. Absent when the deployment has no public address"
              },
              "closedAt": {
                "type": "number",
                "description": "Close time, epoch milliseconds"
              },
              "dueAtIso": {
                "type": "string",
                "description": "The due date as a plain calendar day, \"YYYY-MM-DD\". A DAY, not a moment: the server does no timezone conversion"
              },
              "itemName": {
                "type": "string",
                "description": "The item the ticket is about"
              },
              "priority": {
                "type": "string",
                "description": "low | normal | high"
              },
              "createdAt": {
                "type": "number",
                "description": "When the ticket was reported, epoch milliseconds — the \"since when is it broken?\" answer, and what \"newest first\" sorts on"
              },
              "closedAtIso": {
                "type": "string",
                "description": "The same moment as an ISO-8601 UTC timestamp"
              },
              "primaryCode": {
                "type": "string",
                "description": "The item's printed asset code"
              },
              "assigneeName": {
                "type": "string",
                "description": "Who it is assigned to"
              },
              "createdAtIso": {
                "type": "string",
                "description": "The same moment as an ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
              },
              "reporterName": {
                "type": "string",
                "description": "Who reported it. Absent when nobody did — a maintenance plan minted the ticket, or it came from a logged-out QR report"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update ticket",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "set_item_status",
          "title": "Set item status",
          "description": "Set an item's operational status (condition): available, in_repair, defect, lost or retired, e.g. defect or lost, or available again after a repair. The change goes into the item's activity timeline under the connected user's name, with the optional note. It creates no ticket; create_ticket reports an issue that needs handling and can set the status in the same call (setItemStatus). Requires the manager role; create_ticket is open to members. Quantity-tracked items have no status (refused with quantityItem). Retiring a container that still holds items is refused with containerHasContents; unpack_item empties it, or the app retires it and unpacks its contents in place. Idempotent: the same status again changes nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId",
              "status"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "Short reason, shown in the item's activity timeline"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "status": {
                "enum": [
                  "available",
                  "in_repair",
                  "defect",
                  "lost",
                  "retired"
                ],
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Item id"
              },
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "status": {
                "type": "string",
                "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Present and true only for an unfinished draft capture"
              },
              "modelId": {
                "type": "string",
                "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
              },
              "category": {
                "type": "string",
                "description": "Category name"
              },
              "quantity": {
                "type": "number",
                "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
              },
              "container": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Container item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Container item name"
                  }
                },
                "description": "The container this item is packed into, if any",
                "additionalProperties": {}
              },
              "modelName": {
                "type": "string",
                "description": "The model's name"
              },
              "compartment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Compartment id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Compartment name"
                  }
                },
                "description": "The compartment of that container the item sits in (absent = directly in the container)",
                "additionalProperties": {}
              },
              "description": {
                "type": "string",
                "description": "Item description"
              },
              "primaryCode": {
                "type": "string",
                "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
              },
              "homeLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item belongs",
                "additionalProperties": {}
              },
              "trackingMode": {
                "type": "string",
                "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
              },
              "contentsCount": {
                "type": "number",
                "description": "Direct contents count — containers only"
              },
              "currentHolder": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person currently holding it",
                "additionalProperties": {}
              },
              "currentLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item is now",
                "additionalProperties": {}
              },
              "effectiveHolder": {
                "type": "string",
                "description": "Holder followed through the container chain"
              },
              "effectiveLocation": {
                "type": "string",
                "description": "Location followed through the container chain"
              },
              "responsiblePerson": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person responsible",
                "additionalProperties": {}
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Set item status",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "list_orders",
          "title": "List orders",
          "description": "List orders (material and item requests) in the organization, newest first, grouped by active vs closed. Order managers see all orders; other members see only orders they requested or are assigned to (`isManager` says which view this is). Each row: id, status, requester, deliver-to target, the free-text request, the requested lines (a specific item, any instance of a model (`modelId`), any item of a category (`categoryId`), or free text; each with its `quantity` where one was given: \"5 Packungen Kopierpapier\" is quantity 5), `neededByAt` (when the requester needs it; absent when not given), the assignee and `webUrl`, the order's page in the web app. Every date comes twice, the epoch and its ISO twin: `neededByAtIso` is a plain calendar day (\"2026-08-11\"), `createdAtIso` / `closedAtIso` are UTC instants; the server does no timezone conversion. Statuses: \"open\" = requested, nobody has started fulfilling it; \"in_fulfillment\" = an order manager is working on it; \"fulfilled\" (delivered), \"rejected\" (declined by a manager) and \"cancelled\" (withdrawn by the requester) are closed. \"Open orders\" in the everyday sense are open + in_fulfillment. `status` filters the reads themselves, so it reaches older orders of that status rather than narrowing a capped page. Caps: the newest 100 per active status (open, in_fulfillment) and the newest 50 per closed status (fulfilled, rejected, cancelled), with the closed rows then cut to 50 in total; `truncated: true` means the organization has more orders than returned. An order has no printed code; its `id` is the handle for order tool calls.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "enum": [
                  "open",
                  "in_fulfillment",
                  "fulfilled",
                  "rejected",
                  "cancelled"
                ],
                "type": "string",
                "description": "Only orders with this status (absent = all)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "orders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Order id"
                    },
                    "status": {
                      "type": "string",
                      "description": "open | in_fulfillment | fulfilled | rejected | cancelled"
                    },
                    "target": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Target resource id"
                        },
                        "name": {
                          "type": "string",
                          "description": "Target name"
                        },
                        "type": {
                          "type": "string",
                          "description": "\"person\" or \"location\""
                        }
                      },
                      "description": "Where the order delivers to",
                      "additionalProperties": {}
                    },
                    "webUrl": {
                      "type": "string",
                      "description": "Link to the order in the web app, for a person to open; `id` is the handle for tool calls"
                    },
                    "request": {
                      "type": "string",
                      "description": "Free-text request"
                    },
                    "closedAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "createdAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "neededByAt": {
                      "type": "number",
                      "description": "When the requester needs it, epoch milliseconds at UTC midnight. Absent when they did not say"
                    },
                    "closedAtIso": {
                      "type": "string",
                      "description": "When the order was closed, ISO-8601 UTC timestamp"
                    },
                    "assigneeName": {
                      "type": "string",
                      "description": "Who handles it"
                    },
                    "createdAtIso": {
                      "type": "string",
                      "description": "When the order was placed, ISO-8601 UTC timestamp"
                    },
                    "rejectReason": {
                      "type": "string",
                      "description": "Why it was declined"
                    },
                    "neededByAtIso": {
                      "type": "string",
                      "description": "The needed-by date as a plain calendar day, \"YYYY-MM-DD\". A DAY, not a moment: the server does no timezone conversion"
                    },
                    "requesterName": {
                      "type": "string",
                      "description": "Who asked"
                    },
                    "requestedItems": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "description": "Name of the requested item, model or category as it was when ordered"
                          },
                          "itemId": {
                            "type": "string",
                            "description": "Requested item id"
                          },
                          "modelId": {
                            "type": "string",
                            "description": "Model line: any instance of this model — the store picks which"
                          },
                          "quantity": {
                            "type": "number",
                            "description": "How many were asked for on that line (\"5 Packungen Kopierpapier\" = 5). Absent when the requester named no amount — on BOTH item and free-text lines"
                          },
                          "categoryId": {
                            "type": "string",
                            "description": "Category line: any item of this category, subcategories included — the store picks which"
                          },
                          "description": {
                            "type": "string",
                            "description": "Free-text line (no item attached)"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "description": "Requested lines: an item, a model (any instance), a category (any item in it) or free text"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The orders, active first"
              },
              "isManager": {
                "type": "boolean",
                "description": "False: the rows are only the orders the connected user requested or is assigned to"
              },
              "truncated": {
                "type": "boolean",
                "description": "A bounded read hit its cap"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List orders",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "create_order",
          "title": "Create order",
          "description": "Create an order: a request for items or material (any member can order; order managers fulfill). `lines` holds one entry per thing, each with an optional `quantity`: \"5 Packungen Kopierpapier\" is { description: \"Packungen Kopierpapier\", quantity: 5 }; a specific inventory item is { itemId, quantity } (ids from search_items); \"any two of this drill model\" is { modelId, quantity: 2 } (search_items rows carry the modelId); \"any five from this category\" is { categoryId, quantity: 5 } (category ids from get_item_requirements). For a model or category line the store picks the concrete items, and a line with nothing free is allowed. `request` is free text around it (\"für das Schulzimmer 201\"); at least one of request / lines / itemIds is required. `neededBy` is a calendar day (\"2026-08-11\"); the server has no timezone and does no conversion, so a full timestamp is accepted only WITH an explicit offset (\"2026-08-11T00:00:00+02:00\"). The legacy `neededByAt` epoch still works; exactly one of the two. The result echoes `neededByAtIso`, the day that landed, and `webUrl`, the new order's page in the web app; `orderId` is the handle for follow-up calls. `deliverToResourceId` is the person or location the items go to (ids from search_resources); absent = the connected user. With clientRequestId a repeated call returns the existing order instead of a duplicate; without it every call creates a new order.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "lines": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "itemId": {
                      "type": "string",
                      "description": "This one inventory item (an id from search_items) — exactly one of itemId / modelId / categoryId / description per line"
                    },
                    "modelId": {
                      "type": "string",
                      "description": "Any instance of this model, the store picks which (the modelId of a search_items row) — e.g. \"2 Akku-Bohrschrauber\" when it does not matter which two"
                    },
                    "quantity": {
                      "type": "number",
                      "description": "How many (a whole number ≥ 1). Meaningful for material and stock, not for one serialized machine"
                    },
                    "categoryId": {
                      "type": "string",
                      "description": "Any item of this category, subcategories included, the store picks which (a category id from get_item_requirements) — e.g. \"5 Stichsägeblätter\""
                    },
                    "description": {
                      "type": "string",
                      "description": "Free text for something that is not in the inventory, e.g. \"Packungen Kopierpapier\""
                    }
                  }
                },
                "description": "The requested lines, one entry per thing: a specific inventory item, any instance of a model, any item of a category, or free text, each with an optional quantity"
              },
              "itemIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Shorthand for quantity-less inventory item lines; equivalent to lines: [{ itemId }]"
              },
              "request": {
                "type": "string",
                "description": "Free-text description of what is needed (at least one of request/lines/itemIds is required)"
              },
              "neededBy": {
                "type": "string",
                "description": "When the requester needs it, as a calendar day: \"YYYY-MM-DD\" (e.g. \"2026-08-11\"). This server has no timezone and does no conversion, so a relative date (\"bis Dienstag\") is resolved by the caller. A full timestamp is accepted only WITH an explicit offset (\"2026-08-11T00:00:00+02:00\"), and its calendar day is taken as seen in that offset; an offset-less timestamp is refused. Passing both neededByAt and neededBy is an error"
              },
              "neededByAt": {
                "type": "number",
                "description": "When the requester needs it, as epoch milliseconds at UTC midnight of that day (legacy form of `neededBy`; exactly one of the two)"
              },
              "clientRequestId": {
                "type": "string",
                "description": "A unique id for this request (e.g. a UUID). A repeated call with the SAME id returns the existing order instead of creating a duplicate; a new id creates a new order."
              },
              "deliverToResourceId": {
                "type": "string",
                "description": "Person or location resource id to deliver to; absent = the connected user"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "type": "string",
                "description": "Order status"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to the new order in the web app, for a person to open; `orderId` is the handle for tool calls"
              },
              "orderId": {
                "type": "string",
                "description": "The new order's id"
              },
              "neededByAt": {
                "type": "number",
                "description": "The needed-by date that actually landed, epoch milliseconds. Absent when none was passed"
              },
              "targetName": {
                "type": "string",
                "description": "Who/where it delivers to"
              },
              "neededByAtIso": {
                "type": "string",
                "description": "The same date as a plain calendar day, \"YYYY-MM-DD\": the day that landed. A DAY, not a moment: the server does no timezone conversion"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create order",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "fulfill_order",
          "title": "Fulfill order",
          "description": "Mark an order as fulfilled (delivered); order managers only. Fulfilling transfers reserved stock to the order's target. Three checks answer { requiresAcknowledgment: true, ... } and write nothing; the same call with the named acknowledgment performs it: requested lines that are short (an item line never picked, or a model or category line with fewer picked items than its quantity) come back as `uncovered` (acknowledgeIncomplete: true); picked items that are meanwhile lost/retired come back as `unusableItems` (acknowledgeUnusableItemIds takes their ids); picked items with open issues (status defect or in_repair, an open ticket, or an overdue maintenance check) come back as `itemsWithIssues`, each with its status, the first issue's title and the count (acknowledgeSafetyItemIds). Fails on already-closed orders. Irreversible: a closed order cannot be reopened.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "orderId"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "description": "Order id (from list_orders)"
              },
              "acknowledgeIncomplete": {
                "type": "boolean",
                "description": "true closes the order despite the uncovered lines a previous requiresAcknowledgment result named"
              },
              "acknowledgeSafetyItemIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "The ids from a previous result's itemsWithIssues; the items are handed out despite their issues"
              },
              "acknowledgeUnusableItemIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "The unusable item ids a previous requiresAcknowledgment result named; the order closes despite them"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "type": "string",
                "description": "open | in_fulfillment | fulfilled | rejected | cancelled"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this order in the web app, for a person to open; `orderId` is the handle for tool calls. Absent when the deployment has no public address"
              },
              "orderId": {
                "type": "string",
                "description": "Order id"
              },
              "closedAt": {
                "type": "number",
                "description": "Close time, epoch milliseconds"
              },
              "uncovered": {
                "description": "Requested lines that are short: item lines never picked; model and category lines with `filled` of `required` picked"
              },
              "targetName": {
                "type": "string",
                "description": "Who/where the order delivers to"
              },
              "closedAtIso": {
                "type": "string",
                "description": "The same moment as an ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
              },
              "instruction": {
                "type": "string",
                "description": "Which acknowledge flag performs the call"
              },
              "unusableItems": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Item name"
                    },
                    "itemId": {
                      "type": "string",
                      "description": "Item id"
                    },
                    "status": {
                      "type": "string",
                      "description": "Why it is unusable: lost | retired"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Picked items that are meanwhile lost or retired"
              },
              "itemsWithIssues": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Item name"
                    },
                    "count": {
                      "type": "number",
                      "description": "Open tickets plus overdue checks on the item"
                    },
                    "title": {
                      "type": "string",
                      "description": "The first open ticket's or overdue check's title"
                    },
                    "itemId": {
                      "type": "string",
                      "description": "Item id"
                    },
                    "status": {
                      "type": "string",
                      "description": "defect | in_repair, when the status is one of the two"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Picked items with open issues: status defect or in_repair, an open ticket, or an overdue maintenance check"
              },
              "requiresAcknowledgment": {
                "type": "boolean",
                "description": "Present and true when nothing was written because of what this result names; the SAME call with the acknowledge flag named in `instruction` performs it"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Fulfill order",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "reject_order",
          "title": "Reject order",
          "description": "Reject (decline) an order; order managers only. A non-empty reason is required; the requester is notified with it. Releases any reserved stock. Fails on already-closed orders. Irreversible: a closed order cannot be reopened.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "orderId",
              "reason"
            ],
            "properties": {
              "reason": {
                "type": "string",
                "description": "Required non-empty reason shown to the requester in their notification"
              },
              "orderId": {
                "type": "string",
                "description": "Order id (from list_orders)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "type": "string",
                "description": "open | in_fulfillment | fulfilled | rejected | cancelled"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this order in the web app, for a person to open; `orderId` is the handle for tool calls. Absent when the deployment has no public address"
              },
              "orderId": {
                "type": "string",
                "description": "Order id"
              },
              "closedAt": {
                "type": "number",
                "description": "Close time, epoch milliseconds"
              },
              "targetName": {
                "type": "string",
                "description": "Who/where the order delivers to"
              },
              "closedAtIso": {
                "type": "string",
                "description": "The same moment as an ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Reject order",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "cancel_order",
          "title": "Cancel order",
          "description": "Cancel (withdraw) an order. Only the requester can cancel their OWN order, and only while it is still open; once fulfillment has started the requester cannot cancel it; an order manager can still decline it (reject_order). Releases any reserved stock. Irreversible: a closed order cannot be reopened.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "orderId"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "description": "Order id (from list_orders)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "type": "string",
                "description": "open | in_fulfillment | fulfilled | rejected | cancelled"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this order in the web app, for a person to open; `orderId` is the handle for tool calls. Absent when the deployment has no public address"
              },
              "orderId": {
                "type": "string",
                "description": "Order id"
              },
              "closedAt": {
                "type": "number",
                "description": "Close time, epoch milliseconds"
              },
              "targetName": {
                "type": "string",
                "description": "Who/where the order delivers to"
              },
              "closedAtIso": {
                "type": "string",
                "description": "The same moment as an ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Cancel order",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "stocktaking_status",
          "title": "Stocktaking status",
          "description": "Stocktaking overview: without sessionId, all stocktaking sessions with live progress; with sessionId, the per-location and per-counter breakdown of that session. \"pending\" = not yet counted, \"missing\" = counted as absent: a CLOSED session can have missing items (missing > 0 while pending = 0 is a completed count that found items missing, not a contradiction). Each session carries a `name`; its `id` is the handle for the sessionId argument.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "sessionId": {
                "type": "string",
                "description": "Stocktaking session id"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "totals": {
                "description": "Org-wide counters for one session (expected, confirmed, …)"
              },
              "sessions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Session id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Session name"
                    },
                    "scope": {
                      "type": "string",
                      "description": "Counted scope, or \"whole organization\""
                    },
                    "status": {
                      "type": "string",
                      "description": "open | closed"
                    },
                    "summary": {
                      "description": "Closed-session summary"
                    },
                    "closedAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "progress": {
                      "description": "Counted vs expected so far"
                    },
                    "startedBy": {
                      "type": "string",
                      "description": "Who started it"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "All stocktaking sessions — only in the no-argument mode"
              },
              "perCounter": {
                "description": "Counts per person who counted"
              },
              "perLocation": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "expected": {
                      "type": "number",
                      "description": "Items expected here"
                    },
                    "location": {
                      "type": "string",
                      "description": "Location name"
                    },
                    "confirmed": {
                      "type": "number",
                      "description": "Confirmed in place"
                    },
                    "pendingOrMissing": {
                      "type": "number",
                      "description": "Not counted yet or missing"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Per-room progress for one session"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Stocktaking status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_setup_status",
          "title": "Get setup status",
          "description": "The organization's setup state: name, type, default language, default home location, in-app setup-step progress, whether sample data is active, and counts. Categories, locations and people are each counted over the newest 500 rows, so a bigger organization reads as exactly 500, a lower bound rather than the total; members and items are exact (items = published items, personal drafts excluded); pending invites are exact and returned to admins only. `availableSetupTemplates` lists the templates get_setup_template serves.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "counts": {
                "type": "object",
                "properties": {
                  "items": {
                    "type": "number",
                    "description": "Published items (drafts excluded)"
                  },
                  "people": {
                    "type": "number",
                    "description": "Person records"
                  },
                  "members": {
                    "type": "number",
                    "description": "Login accounts in the org"
                  },
                  "locations": {
                    "type": "number",
                    "description": "Locations"
                  },
                  "categories": {
                    "type": "number",
                    "description": "Categories"
                  },
                  "pendingInvites": {
                    "type": "number",
                    "description": "Open invites — owners only"
                  }
                },
                "description": "Rough org size",
                "additionalProperties": {}
              },
              "yourRole": {
                "type": "string",
                "description": "The connected user's role: owner | manager | member | viewer"
              },
              "setupSteps": {
                "description": "Wizard bookkeeping: done/skipped per step; absent key = untouched"
              },
              "organization": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Organization name"
                  },
                  "orgType": {
                    "type": "string",
                    "description": "school | company | publicAdmin | publicWorks | club | other; absent = never set"
                  },
                  "defaultCurrency": {
                    "type": "string",
                    "description": "ISO 4217 code a NEW currency field gets when created without currencyCode (change with set_org_defaults)"
                  },
                  "defaultLanguage": {
                    "type": "string",
                    "description": "\"en\", \"de\", \"fr\", \"es\" or \"it\""
                  },
                  "defaultHomeLocation": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Resource id"
                      },
                      "name": {
                        "type": "string",
                        "description": "Resource name"
                      },
                      "archived": {
                        "type": "boolean",
                        "const": true,
                        "description": "The referenced resource is archived"
                      }
                    },
                    "description": "Fallback home location for new items",
                    "additionalProperties": {}
                  }
                },
                "description": "Org identity and defaults",
                "additionalProperties": {}
              },
              "sampleDataActive": {
                "type": "boolean",
                "description": "Whether demo records are currently loaded"
              },
              "availableSetupTemplates": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Template ids for get_setup_template"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Get setup status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "scaffold_categories",
          "title": "Scaffold category tree",
          "description": "Create a whole category tree with custom field definitions in one call. Without confirm: true it is a dry run that writes NOTHING and returns the plan: per node, created vs already exists (same-name nodes at the same tree position are reused, never duplicated). The SAME call with confirm: true commits the whole tree atomically. parentName references another entry in the same call (names are unique per call; existing parents included as entries are matched and reused). Each category may carry `fields` (custom field definitions) and defaultHomeLocationName (an existing location's exact name). orgWideFields apply to ALL items. A field whose label already exists at the same scope is reused; a type mismatch is reported as a conflict and skipped on commit. get_setup_template returns starting trees in this input shape. At most 100 categories and 200 fields (orgWideFields included) per call. Requires the manager role. Idempotent: a repeated commit reuses every node.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "categories"
            ],
            "properties": {
              "confirm": {
                "type": "boolean",
                "description": "true commits the plan; absent or false = dry run, nothing written"
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name"
                  ],
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Category name (unique within this call)"
                    },
                    "fields": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "label",
                          "type"
                        ],
                        "properties": {
                          "type": {
                            "enum": [
                              "text",
                              "number",
                              "currency",
                              "date",
                              "select",
                              "multiselect",
                              "boolean",
                              "url"
                            ],
                            "type": "string",
                            "description": "Value type — immutable after creation. currency = money amount (numeric value, rendered code-first like CHF 1'200.50; without currencyCode a new field gets the organization's default currency); url = http(s) link (clickable in the app); multiselect = several options at once (value is an array of option strings)"
                          },
                          "label": {
                            "type": "string",
                            "description": "Field label shown in the app"
                          },
                          "unique": {
                            "type": "boolean",
                            "description": "Enforce distinct values across the organization (text/number only — e.g. serial or inventory numbers)"
                          },
                          "options": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Allowed values — required for select and multiselect, forbidden otherwise"
                          },
                          "required": {
                            "type": "boolean",
                            "description": "Required fields make items incomplete until filled"
                          },
                          "currencyCode": {
                            "type": "string",
                            "description": "ISO 4217 code for currency fields only (e.g. EUR) — absent = the organization's default currency (defaultCurrency in get_setup_status), which is written into the new field. All of the field's values are amounts in THIS one currency."
                          }
                        }
                      },
                      "description": "Custom field definitions for this category"
                    },
                    "parentName": {
                      "type": "string",
                      "description": "Name of the parent category — another entry in this call (omit for top level)"
                    },
                    "defaultHomeLocationName": {
                      "type": "string",
                      "description": "Exact name of an EXISTING location new items of this category should live in by default"
                    }
                  }
                },
                "description": "The whole tree as a flat list, parents referenced by name"
              },
              "orgWideFields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "label",
                    "type"
                  ],
                  "properties": {
                    "type": {
                      "enum": [
                        "text",
                        "number",
                        "currency",
                        "date",
                        "select",
                        "multiselect",
                        "boolean",
                        "url"
                      ],
                      "type": "string",
                      "description": "Value type — immutable after creation. currency = money amount (numeric value, rendered code-first like CHF 1'200.50; without currencyCode a new field gets the organization's default currency); url = http(s) link (clickable in the app); multiselect = several options at once (value is an array of option strings)"
                    },
                    "label": {
                      "type": "string",
                      "description": "Field label shown in the app"
                    },
                    "unique": {
                      "type": "boolean",
                      "description": "Enforce distinct values across the organization (text/number only — e.g. serial or inventory numbers)"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Allowed values — required for select and multiselect, forbidden otherwise"
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Required fields make items incomplete until filled"
                    },
                    "currencyCode": {
                      "type": "string",
                      "description": "ISO 4217 code for currency fields only (e.g. EUR) — absent = the organization's default currency (defaultCurrency in get_setup_status), which is written into the new field. All of the field's values are amounts in THIS one currency."
                    }
                  }
                },
                "description": "Field definitions that apply to ALL items regardless of category"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "reused": {
                    "type": "number",
                    "description": "Field definitions reused"
                  },
                  "created": {
                    "type": "number",
                    "description": "Field definitions created"
                  }
                },
                "description": "Field totals — commit mode",
                "additionalProperties": {}
              },
              "preview": {
                "type": "boolean",
                "description": "True = dry run, NOTHING was written; the same call with confirm: true commits it"
              },
              "summary": {
                "description": "Counts: createCategories, reuseCategories, createFields, reuseFields, conflicts"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Rows skipped on commit (conflicting fields, unresolvable locations)"
              },
              "committed": {
                "type": "boolean",
                "description": "True = the plan was executed"
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Category name"
                    },
                    "action": {
                      "type": "string",
                      "description": "\"create\" (new) or \"existing\" (name-matched and reused)"
                    },
                    "fields": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Field label"
                          },
                          "action": {
                            "type": "string",
                            "description": "\"create\", \"existing\" or \"conflict\" (skipped on commit)"
                          },
                          "reason": {
                            "type": "string",
                            "description": "Why a conflict row conflicts"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "description": "Per-field verdicts — preview mode"
                    },
                    "categoryId": {
                      "type": "string",
                      "description": "Category id — commit mode"
                    },
                    "parentName": {
                      "type": "string",
                      "description": "Parent in the same batch"
                    },
                    "defaultHomeLocation": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Requested location name"
                        },
                        "status": {
                          "type": "string",
                          "description": "willSet | unknownLocation | ambiguousLocation"
                        }
                      },
                      "description": "Default home location verdict — preview mode",
                      "additionalProperties": {}
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Per-category verdicts (preview) or created/reused rows (commit)"
              },
              "instruction": {
                "type": "string",
                "description": "Preview mode: what the same call with confirm: true would do"
              },
              "orgWideFields": {
                "description": "Verdicts for fields that apply to every item — preview mode"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Scaffold category tree",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "scaffold_locations",
          "title": "Scaffold location tree",
          "description": "Create a whole location tree (buildings, floors, rooms, storage places) in one call, with the same contract as scaffold_categories: without confirm: true it is a dry run that writes nothing (existing same-name locations at the same position are reused, never duplicated); the SAME call with confirm: true commits the tree atomically. parentName references another entry in the same call (existing parents included as entries are reused). Each location is one explicit entry: a range such as \"rooms 201 to 210\" is ten entries. At most 200 locations per call. Requires the manager role. Idempotent: a repeated commit reuses every node.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "locations"
            ],
            "properties": {
              "confirm": {
                "type": "boolean",
                "description": "true commits the plan; absent or false = dry run, nothing written"
              },
              "locations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name"
                  ],
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Location name (unique within this call)"
                    },
                    "parentName": {
                      "type": "string",
                      "description": "Name of the parent location — another entry in this call (omit for top level)"
                    }
                  }
                },
                "description": "The whole tree as a flat list, parents referenced by name"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "preview": {
                "type": "boolean",
                "description": "True = dry run, NOTHING was written; the same call with confirm: true commits it"
              },
              "summary": {
                "description": "Counts: create, reuse — preview mode"
              },
              "committed": {
                "type": "boolean",
                "description": "True = the plan was executed"
              },
              "locations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Location name"
                    },
                    "action": {
                      "type": "string",
                      "description": "\"create\" (new) or \"existing\" (name-matched and reused)"
                    },
                    "locationId": {
                      "type": "string",
                      "description": "Location id — commit mode"
                    },
                    "parentName": {
                      "type": "string",
                      "description": "Parent in the same batch"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Per-location verdicts (preview) or created/reused rows (commit)"
              },
              "instruction": {
                "type": "string",
                "description": "Preview mode: what the same call with confirm: true would do"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Scaffold location tree",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "scaffold_models",
          "title": "Scaffold item models",
          "description": "Create item models («Modelle») in one call: one model per article type whose pieces share a name and settings, e.g. «Arbeitshose» in sizes XS to 8XL, or 16 identical radios. Same contract as scaffold_categories: without confirm: true it is a dry run that writes nothing; the SAME call with confirm: true commits. Per model: name, categoryId, and how its pieces are named: nameSuffix \"none\" (every piece carries the model's name), \"text\" (each piece keeps its own suffix from its row: «Funkgerät 3») or \"field\" with nameSuffixFieldId (a select, text or number field: «Arbeitshose XL»); variantValues, the values a field may take on this model (the sizes it exists in); defaultFieldValues, the values every new piece gets. An existing model of the same name is reused, never duplicated; one whose settings differ (category, name suffix, allowed values, or a named default) is reported as a conflict and left as it is. Models are created last to first, so the app's model list opens on the first one. plan_import adds the pieces: the model's name in a blueprintName column and the size in its field's column. Model pictures are added in the app. At most 50 models per call. Requires the manager role. Idempotent: a repeated commit reuses every model.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "models"
            ],
            "properties": {
              "models": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "categoryId"
                  ],
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Model name (unique within this call)"
                    },
                    "categoryId": {
                      "type": "string",
                      "description": "Category id (from scaffold_categories or get_item_requirements)"
                    },
                    "nameSuffix": {
                      "enum": [
                        "none",
                        "text",
                        "field"
                      ],
                      "type": "string",
                      "description": "How its pieces are named: \"none\" = the model name, \"text\" = each piece its own suffix, \"field\" = the value of nameSuffixFieldId. Default \"none\" (\"field\" when nameSuffixFieldId is set)"
                    },
                    "variantValues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "field",
                          "values"
                        ],
                        "properties": {
                          "field": {
                            "type": "string",
                            "description": "A field id (from get_item_requirements) or \"field:<label>\""
                          },
                          "values": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The values this field may take on the model (select: its options)"
                          }
                        }
                      },
                      "description": "Allowed values per field — the sizes or variants"
                    },
                    "nameSuffixFieldId": {
                      "type": "string",
                      "description": "A field id (from get_item_requirements) or \"field:<label>\" — a select, text or number field of the category whose value ends each piece's name"
                    },
                    "defaultFieldValues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "field",
                          "value"
                        ],
                        "properties": {
                          "field": {
                            "type": "string",
                            "description": "A field id (from get_item_requirements) or \"field:<label>\""
                          },
                          "value": {
                            "type": "string",
                            "description": "The value as text: a date as \"YYYY-MM-DD\" (a calendar day, no time zone to convert), a number as \"12.5\", a select value as one of its options, a multi-select value as several of its options separated by \";\" (\"HDMI; VGA\" — not commas: an option name may itself contain a comma)"
                          }
                        }
                      },
                      "description": "Values every new piece of this model gets"
                    }
                  }
                },
                "description": "The models, at most 50 per call"
              },
              "confirm": {
                "type": "boolean",
                "description": "true commits the plan; absent or false = dry run, nothing written"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "models": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Why an invalid row is invalid (the app's code)"
                    },
                    "name": {
                      "type": "string",
                      "description": "Model name"
                    },
                    "field": {
                      "type": "string",
                      "description": "The field the code is about"
                    },
                    "action": {
                      "type": "string",
                      "description": "\"create\", \"existing\" (same name, reused), \"conflict\" (same name, other settings — left unchanged) or \"invalid\" (skipped)"
                    },
                    "detail": {
                      "type": "string",
                      "description": "How to fix an invalid row"
                    },
                    "webUrl": {
                      "type": "string",
                      "description": "The model's page in the web app, for a person to open; the id is the handle for tool calls"
                    },
                    "modelId": {
                      "type": "string",
                      "description": "The model's id — created (commit) or existing"
                    },
                    "differences": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "What differs on a conflict row"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "One row per model, in the order of the request"
              },
              "preview": {
                "type": "boolean",
                "description": "True = dry run, NOTHING was written; the same call with confirm: true commits it"
              },
              "summary": {
                "description": "Counts: create, existing, conflict, invalid"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Rows skipped on commit — commit mode"
              },
              "committed": {
                "type": "boolean",
                "description": "True = the plan was executed"
              },
              "instruction": {
                "type": "string",
                "description": "Preview mode: what the same call with confirm: true would do"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Scaffold item models",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_category",
          "title": "Create category",
          "description": "Create ONE category, optionally under a parent category id (ids from get_item_requirements). scaffold_categories creates a whole tree with a dry run and reuses existing nodes. Not idempotent: a repeated call creates a same-name sibling. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Category name"
              },
              "parentId": {
                "type": "string",
                "description": "Parent category id (omit for top level)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Category name as stored (trimmed)"
              },
              "categoryId": {
                "type": "string",
                "description": "The new category's id"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create category",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_category",
          "title": "Update category",
          "description": "Update a category (ids from get_item_requirements), any combination in one call: rename it; holdsItems, the container switch for its items (true = its items can hold other items: vehicles, cases, carts; false = its items are not offered as containers, even where a parent category says yes, but an item that already holds things or whose own switch says yes stays a container; null = follow the parent category again); defaultHomeLocationId, where its new items live (a location id from search_resources; null clears it); hideFieldIds / showFieldIds, inherited fields (org-wide or from a parent category; a field id or \"field:<label>\") this category and its sub-categories do not use: the field disappears from their items, and their values are kept and come back when it is shown again. A field defined ON this category cannot be hidden. Moving a category is app-only. Nothing is written if one part is refused. Requires the manager role. Idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "categoryId"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "New name"
              },
              "categoryId": {
                "type": "string",
                "description": "Category id"
              },
              "holdsItems": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Container switch: true = its items can hold other items, false = its items are not offered as containers (an item that already holds things or whose own switch says yes stays one), null = follow the parent category"
              },
              "hideFieldIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Inherited fields (ids or \"field:<label>\") this category and its sub-categories do not use"
              },
              "showFieldIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Hidden fields (ids or \"field:<label>\") to show again"
              },
              "defaultHomeLocationId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Location id new items of this category live in; null clears it"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Category name as stored (trimmed)"
              },
              "note": {
                "type": "string",
                "description": "Set when nothing was changed"
              },
              "categoryId": {
                "type": "string",
                "description": "The category's id"
              },
              "holdsItems": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "The category's own container switch; null = it follows its parent"
              },
              "hiddenFieldIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Inherited fields this category hides"
              },
              "defaultHomeLocationId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Where its new items live; null = none set"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update category",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "archive_category",
          "title": "Archive unused category",
          "description": "Archive a category that nothing uses, e.g. a starter category the organization does not need. Refused, with nothing written, while anything still uses it: items (drafts too), sub-categories, item models, fields defined on it, a maintenance plan that selects it, or an item kit that lists it; the answer names what. An archived category leaves every list and picker, and the app has no way to bring it back. Repeating the call on an archived category answers alreadyArchived and writes nothing. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "categoryId"
            ],
            "properties": {
              "categoryId": {
                "type": "string",
                "description": "Category id"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Category name"
              },
              "note": {
                "type": "string",
                "description": "Counting caveat"
              },
              "inUse": {
                "description": "On a refusal, what still uses it: items, drafts, subCategories, models, fields, maintenancePlans, kits (counts)"
              },
              "archived": {
                "type": "boolean",
                "description": "True = archived; false = refused, nothing written"
              },
              "categoryId": {
                "type": "string",
                "description": "The category's id"
              },
              "instruction": {
                "type": "string",
                "description": "Why the call was refused"
              },
              "alreadyArchived": {
                "type": "boolean",
                "description": "It was archived before this call"
              },
              "readLimitReached": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Areas this check could not read in full — refused for safety, nothing written"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Archive unused category",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "create_field_def",
          "title": "Create field definition",
          "description": "Create ONE custom field definition for items, on a category (categoryId) or org-wide (no categoryId: applies to ALL items). Types: text, number, currency (money amount, numeric value; per-field currencyCode, default = the organization's default currency), date, select (with options), multiselect (several options at once, value = array of option strings), boolean, url (http(s) link). `required` makes items incomplete until filled; `unique` (text/number) enforces distinct values across the organization, e.g. serial or inventory numbers. scaffold_categories creates several fields at once. Not idempotent: a repeated call creates a second field. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "label",
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "text",
                  "number",
                  "currency",
                  "date",
                  "select",
                  "multiselect",
                  "boolean",
                  "url"
                ],
                "type": "string"
              },
              "label": {
                "type": "string",
                "description": "Field label shown in the app"
              },
              "unique": {
                "type": "boolean",
                "description": "Enforce distinct values (text/number only)"
              },
              "options": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Allowed values — required for select and multiselect, forbidden otherwise"
              },
              "required": {
                "type": "boolean"
              },
              "categoryId": {
                "type": "string",
                "description": "Category id — omit for an org-wide field"
              },
              "currencyCode": {
                "type": "string",
                "description": "ISO 4217 code for currency fields only (e.g. EUR) — absent = the organization's default currency (defaultCurrency in get_setup_status), which is written into the new field. All of the field's values are amounts in THIS one currency; values render code-first (EUR 1'234.50)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "type": {
                "type": "string",
                "description": "Field type (immutable once created)"
              },
              "label": {
                "type": "string",
                "description": "Field label as stored (trimmed)"
              },
              "required": {
                "type": "boolean",
                "description": "Whether a value is mandatory"
              },
              "fieldDefId": {
                "type": "string",
                "description": "The new field definition's id"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create field definition",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_field_def",
          "title": "Update field definition",
          "description": "Update a custom field definition: rename the label, flip required, replace a select's options, or change a currency field's currencyCode. The TYPE is immutable, because changing it would invalidate every stored value; a different type means a new field (archiving the old one happens in the app). Changing currencyCode relabels existing values without converting them: the numbers stay as entered. Field ids come from get_item_requirements. Requires the manager role. Idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "fieldDefId"
            ],
            "properties": {
              "label": {
                "type": "string",
                "description": "New label"
              },
              "options": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Replacement option list (select/multiselect fields only)"
              },
              "required": {
                "type": "boolean"
              },
              "fieldDefId": {
                "type": "string",
                "description": "Field definition id"
              },
              "currencyCode": {
                "type": "string",
                "description": "ISO 4217 code (currency fields only), e.g. EUR or CHF. The organization's default currency applies only when a field is created. Relabels existing values, never converts them."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "type": {
                "type": "string",
                "description": "Field type: text | number | date | select | multiselect | …"
              },
              "label": {
                "type": "string",
                "description": "Field label as the org named it"
              },
              "options": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Allowed values for selects"
              },
              "required": {
                "type": "boolean",
                "description": "Whether a value is mandatory"
              },
              "fieldDefId": {
                "type": "string",
                "description": "Field definition id"
              },
              "currencyCode": {
                "type": "string",
                "description": "ISO code of a currency field when it is not CHF (absent = CHF)"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update field definition",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "create_location",
          "title": "Create location",
          "description": "Create ONE location, optionally under a parent location id (ids from search_resources). scaffold_locations creates a whole tree with a dry run and reuses existing nodes. Not idempotent: a repeated call creates a same-name sibling. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Location name"
              },
              "parentId": {
                "type": "string",
                "description": "Parent location resource id (omit for top level)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Location name as stored (trimmed)"
              },
              "locationId": {
                "type": "string",
                "description": "The new location's resource id"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create location",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "create_person",
          "title": "Create person",
          "description": "Create a person record: someone items can be assigned to. This is NOT a login account; create_invite invites someone into the app, and an accepted invite links to a person record (matched by email where possible). Optional email and parent person id (grouping, e.g. a department). Not idempotent: a repeated call creates a second record. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Person name"
              },
              "email": {
                "type": "string",
                "description": "Email (used to link an account later)"
              },
              "parentId": {
                "type": "string",
                "description": "Parent person resource id for grouping (omit for top level)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Person name as stored (trimmed)"
              },
              "personId": {
                "type": "string",
                "description": "The new person's resource id"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create person",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "set_org_type",
          "title": "Set organization type",
          "description": "Set the organization's type: school, company, publicAdmin, publicWorks, club or other. It tailors the in-app experience. Idempotent. Only the organization's creator or an admin can set it.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "orgType"
            ],
            "properties": {
              "orgType": {
                "enum": [
                  "school",
                  "company",
                  "publicAdmin",
                  "publicWorks",
                  "club",
                  "other"
                ],
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "orgType": {
                "type": "string",
                "description": "The org type that was stored"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Set organization type",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "set_org_defaults",
          "title": "Set organization defaults",
          "description": "Set organization-wide defaults, any combination in one call: defaultHomeLocationId (where new items live by default; a location resource id), defaultResponsiblePersonId (who is responsible for every item that names nobody; a PERSON resource id), defaultLanguage (en/de/fr/es/it: emails and new members), defaultCurrency (ISO 4217 code such as EUR: the currency a NEW currency field gets when none is named; existing fields keep theirs), orderDefaultAssigneeUserId and ticketDefaultAssignees (who handles incoming orders / tickets of a type by default; userIds from list_members; the target must already be responsible for orders/tickets there, see responsibleForOrders/responsibleForTickets). Admin only. Idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "defaultCurrency": {
                "type": "string",
                "description": "ISO 4217 code (e.g. CHF, EUR, GBP, USD) that a new currency field gets when it is created without currencyCode. Changing it never touches existing fields or their values"
              },
              "defaultLanguage": {
                "enum": [
                  "en",
                  "de",
                  "fr",
                  "es",
                  "it"
                ],
                "type": "string"
              },
              "defaultHomeLocationId": {
                "type": "string",
                "description": "Location resource id new items default to"
              },
              "ticketDefaultAssignees": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "ticketType",
                    "userId"
                  ],
                  "properties": {
                    "userId": {
                      "type": "string",
                      "description": "userId from list_members"
                    },
                    "ticketType": {
                      "enum": [
                        "defect",
                        "maintenance",
                        "inspection",
                        "other"
                      ],
                      "type": "string"
                    }
                  }
                },
                "description": "Per-ticket-type default handlers"
              },
              "defaultResponsiblePersonId": {
                "type": "string",
                "description": "Person resource id (from search_resources) who is responsible for every item that names nobody — the last link of the chain blueprint > category > organization. The person must have a member account in this organization. It can be repointed but never cleared: the organization always has one"
              },
              "orderDefaultAssigneeUserId": {
                "type": "string",
                "description": "userId (from list_members) who handles incoming orders by default"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string",
                "description": "Present when nothing changed"
              },
              "updated": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Which defaults were written (empty when no argument was passed)"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Set organization defaults",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "create_invite",
          "title": "Invite member",
          "description": "Invite someone into the organization by email, with a role: owner (admin), manager, member or viewer. An invite grants access to the organization's data at that role once accepted. The result says whether the invite email was queued; when it was not (no email configured, delivery failure) the invite still exists, and its link can be shared from the app's Members page. A live pending invite for the same address is refused (invitePending), so a repeated call never duplicates. Admin only.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "email",
              "role"
            ],
            "properties": {
              "role": {
                "enum": [
                  "owner",
                  "manager",
                  "member",
                  "viewer"
                ],
                "type": "string",
                "description": "Role in the organization — owner is the admin role"
              },
              "email": {
                "type": "string",
                "description": "Invitee email address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string",
                "description": "Present when no email went out — share the link from the app"
              },
              "role": {
                "type": "string",
                "description": "Role the invite grants"
              },
              "inviteId": {
                "type": "string",
                "description": "The new invite's id"
              },
              "emailFailed": {
                "type": "boolean",
                "description": "True = delivery failed"
              },
              "emailQueued": {
                "type": "boolean",
                "description": "True = the invite email was handed to the provider"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Invite member",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_members",
          "title": "List members",
          "description": "List the organization's members: userId, name, email, role (owner = admin, manager, member, viewer) and whether they are responsible for orders/tickets. The userIds are what set_org_defaults, add_team_member and list_activity's actorUserId take. Members are login accounts; the person records items get assigned to come from search_resources.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "members": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Member name"
                    },
                    "role": {
                      "type": "string",
                      "description": "owner | manager | member | viewer"
                    },
                    "email": {
                      "type": "string",
                      "description": "Member email"
                    },
                    "isYou": {
                      "type": "boolean",
                      "description": "Present only for the connected user"
                    },
                    "userId": {
                      "type": "string",
                      "description": "Member userId — the id add_team_member and the assignee defaults want"
                    },
                    "deactivated": {
                      "type": "boolean",
                      "description": "Present only when true"
                    },
                    "responsibleForOrders": {
                      "type": "boolean",
                      "description": "Handles incoming orders"
                    },
                    "responsibleForTickets": {
                      "description": "Ticket types this member handles"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Login accounts in the org — NOT person records (search_resources)"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List members",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "sample_data",
          "title": "Add or remove sample data",
          "description": "Load or clear the sample data: a small example inventory (categories, places, people, items and a few tickets, all marked as samples) for a new organization to look around in. action \"add\" loads it; while it is loaded a second add changes nothing. packKey picks the set (absent = the set that fits this organization). Sample items do not count against the item allowance. action \"remove\" deletes exactly the sample records, including ones edited since they were loaded, and nothing restores them as they were; records the organization created stay, and a sample category or place that its own records use is archived instead. A big set finishes removing in the background (outcome \"removing\"). Owner only.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "action"
            ],
            "properties": {
              "action": {
                "enum": [
                  "add",
                  "remove"
                ],
                "type": "string",
                "description": "add = load the sample set, remove = delete it again"
              },
              "packKey": {
                "enum": [
                  "general",
                  "school",
                  "construction",
                  "club",
                  "publicSector",
                  "trades",
                  "office",
                  "industry",
                  "fireService"
                ],
                "type": "string",
                "description": "Only for add: which sample set; absent = the set that fits this organization"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string",
                "description": "A note on the outcome"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to the items list in the web app, where the sample items show"
              },
              "outcome": {
                "type": "string",
                "description": "added | alreadyActive | notOffered (this organization's own showcase set was removed; nothing else is offered) | removing (continues in the background) | removed | notActive (there was nothing to remove)"
              },
              "packKey": {
                "type": "string",
                "description": "Which sample set is loaded (custom = the organization's own showcase content)"
              },
              "sampleDataActive": {
                "type": "boolean",
                "description": "Whether sample records are loaded after this call"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Add or remove sample data",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "update_item",
          "title": "Update item",
          "description": "Update an inventory item: rename it, edit the description (null clears it), and set custom field values (keys = fieldDefId from get_item_requirements; null clears a value). Unchanged values are skipped, and every real change lands in the item's activity timeline under the connected user's name. If the edit would clear required values the call returns { missingFields } and changes nothing. Items that belong to a model cannot be renamed here (the model owns the name). Other tools change the rest: set_item_status the status, assign_item location and holder, adjust_stock and transfer_stock stock amounts; the category changes in the app only. Requires the manager role. Idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "New item name"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "New description, or null to clear"
              },
              "customFields": {
                "type": "object",
                "description": "Field values keyed by fieldDefId (from get_item_requirements); null clears a value. Dates as a plain calendar day \"YYYY-MM-DD\" (a full timestamp works too, but only WITH an explicit offset — this server has no timezone and does no conversion), selects as one of the listed options, multiselect as an ARRAY of option strings, currency as a plain number in the field's own currency (see its currencyCode; default CHF), url as a full http(s) link (protocol added when missing).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Item id"
              },
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "status": {
                "type": "string",
                "description": "Condition: available | in_repair | defect | lost | retired (\"available\" means not defect/lost/retired — the item may still be borrowed)"
              },
              "webUrl": {
                "type": "string",
                "description": "Link to this item in the web app, for a person to open. Absent when the deployment has no public address configured"
              },
              "isDraft": {
                "type": "boolean",
                "description": "Present and true only for an unfinished draft capture"
              },
              "modelId": {
                "type": "string",
                "description": "The item's model — pass it as create_order lines[].modelId to order any instance of this model"
              },
              "category": {
                "type": "string",
                "description": "Category name"
              },
              "quantity": {
                "type": "number",
                "description": "How many this row stands for — only on quantity-tracked pools. To count a pool, SUM this; to count serialized items, count rows"
              },
              "container": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Container item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Container item name"
                  }
                },
                "description": "The container this item is packed into, if any",
                "additionalProperties": {}
              },
              "modelName": {
                "type": "string",
                "description": "The model's name"
              },
              "compartment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Compartment id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Compartment name"
                  }
                },
                "description": "The compartment of that container the item sits in (absent = directly in the container)",
                "additionalProperties": {}
              },
              "description": {
                "type": "string",
                "description": "Item description"
              },
              "instruction": {
                "type": "string",
                "description": "Which values are missing"
              },
              "primaryCode": {
                "type": "string",
                "description": "The code printed on the item's asset tag — how a human tells two identical models apart. Absent when no code is attached"
              },
              "homeLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item belongs",
                "additionalProperties": {}
              },
              "trackingMode": {
                "type": "string",
                "description": "\"quantity\" for a stock pool counted by amount. Absent = a serialized item, i.e. this row IS one physical thing"
              },
              "contentsCount": {
                "type": "number",
                "description": "Direct contents count — containers only"
              },
              "currentHolder": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person currently holding it",
                "additionalProperties": {}
              },
              "missingFields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "Field type: text | number | date | select | multiselect | …"
                    },
                    "label": {
                      "type": "string",
                      "description": "Field label as the org named it"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Allowed values for selects"
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether a value is mandatory"
                    },
                    "fieldDefId": {
                      "type": "string",
                      "description": "Field definition id"
                    },
                    "currencyCode": {
                      "type": "string",
                      "description": "ISO code of a currency field when it is not CHF (absent = CHF)"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Present instead of the item when the edit would clear required values — nothing was changed"
              },
              "currentLocation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Where the item is now",
                "additionalProperties": {}
              },
              "effectiveHolder": {
                "type": "string",
                "description": "Holder followed through the container chain"
              },
              "effectiveLocation": {
                "type": "string",
                "description": "Location followed through the container chain"
              },
              "responsiblePerson": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Resource id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Resource name"
                  },
                  "archived": {
                    "type": "boolean",
                    "const": true,
                    "description": "The referenced resource is archived"
                  }
                },
                "description": "Person responsible",
                "additionalProperties": {}
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update item",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "my_tasks",
          "title": "My tasks",
          "description": "Everything on the connected user's plate right now (\"what's on my plate?\", \"what should I do today?\"). One merged list, exactly what the app's My-tasks page shows: tickets assigned to them or their teams, orders they should fulfill, stocktaking rooms to count, low-stock restock signals, maintenance-run batches (one row per plan with openCount) and pending setup handovers. section \"mine\" = theirs to act on; section \"team\" = a teammate took team work over (holder says who). In section \"mine\" the maintenance row REPLACES the plan's individual run tickets: they are not in this list, because the plan is what a person acts on, and the per-check rows behind openCount are not returned. In section \"team\", run tickets a teammate took over stay individual rows, because the holder is per ticket. Rows carry the ids follow-up calls take (ticketId, orderId, planId, sessionId, ...) and a title where the task has one. Dates come twice, epoch and ISO twin: `dueAtIso` is a plain calendar day, `sinceIso` the UTC instant the work started waiting (`sinceMs` is a moment, not a duration); the server does no timezone conversion. An empty list means nothing is on their plate.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "tasks": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "dueAt": {
                      "type": "number",
                      "description": "Due date, epoch milliseconds"
                    },
                    "title": {
                      "type": "string",
                      "description": "Task title, when it has one"
                    },
                    "holder": {
                      "description": "Who took it over, for team rows"
                    },
                    "source": {
                      "type": "string",
                      "description": "What generated the task (ticket, order, restock, setup, …)"
                    },
                    "section": {
                      "type": "string",
                      "description": "\"mine\" = act on it; \"team\" = a teammate took it over"
                    },
                    "sinceMs": {
                      "type": "number",
                      "description": "When this started waiting for the connected user, epoch milliseconds. A MOMENT despite the name, not a duration"
                    },
                    "dueAtIso": {
                      "type": "string",
                      "description": "The due date as a plain calendar day, \"YYYY-MM-DD\"; a day, not a moment, so no timezone applies"
                    },
                    "sinceIso": {
                      "type": "string",
                      "description": "The same moment as an ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
                    },
                    "viaTeamName": {
                      "type": "string",
                      "description": "Team that routed it to the connected user"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The connected user's to-do rows. Each row also carries its own payload ids (ticketId, orderId, itemId, …) for follow-up calls."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "My tasks",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "maintenance_status",
          "title": "Maintenance status",
          "description": "Maintenance status: \"what maintenance is due?\" (overdue / this month / next quarter). Without arguments: the organization overview with counts (overdue, dueSoon, blocked), one card per maintenance plan in `plans` (name, assignee, matchedCount / overdueCount / dueSoonCount / openTicketCount), the due list for the next ~90 days sorted soonest first (each row names its plan, its item and, when a run ticket exists, its ticketId) and the blocked rows. A maintenance plan holds its checks together and is the level a person acts on, so the plan cards summarize what the due list details per item. Every plan has exactly ONE default assignee (a person or a team), so all its checks land on the same target by design. With itemId: that item's maintenance plans with last completed, next due and open ticket. Every date comes twice, epoch and ISO twin: `nextDueAtIso`, `openTicketDueAtIso` and the due list's `dueAtIso` are plain calendar days, `lastCompletedAtIso` is a UTC instant; the server does no timezone conversion. Read-only report: recording a check as done (walking its checklist) and creating or editing plans happen in the app only.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id: returns that item's plan rows instead of the org overview"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "due": {
                "description": "Checks due within 90 days (overdue first), each naming its plan, item and open ticketId, plus `dueAt` (epoch) and `dueAtIso` (the plain calendar day, \"YYYY-MM-DD\" — read that one) — overview mode"
              },
              "item": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Item id"
                  },
                  "name": {
                    "type": "string",
                    "description": "Item name"
                  }
                },
                "description": "The item — itemId mode only",
                "additionalProperties": {}
              },
              "plans": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Plan id — overview mode"
                    },
                    "name": {
                      "type": "string",
                      "description": "Plan name — overview mode"
                    },
                    "planId": {
                      "type": "string",
                      "description": "Plan id — itemId mode"
                    },
                    "status": {
                      "type": "string",
                      "description": "active | paused"
                    },
                    "blocked": {
                      "description": "Why the row cannot be scheduled"
                    },
                    "planName": {
                      "type": "string",
                      "description": "Plan name — itemId mode"
                    },
                    "schedule": {
                      "description": "Recurrence rule"
                    },
                    "nextDueAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "planStatus": {
                      "type": "string",
                      "description": "active | paused — itemId mode"
                    },
                    "assigneeName": {
                      "type": "string",
                      "description": "Default assignee"
                    },
                    "dueSoonCount": {
                      "type": "number",
                      "description": "Of those, due soon"
                    },
                    "leadTimeDays": {
                      "type": "number",
                      "description": "How early the run ticket opens"
                    },
                    "matchedCount": {
                      "type": "number",
                      "description": "Items the plan covers"
                    },
                    "nextDueAtIso": {
                      "type": "string",
                      "description": "When the next check is due, as a plain calendar day \"YYYY-MM-DD\": a DAY, not a moment, so no timezone applies"
                    },
                    "openTicketId": {
                      "type": "string",
                      "description": "The open run ticket's id, a handle for tool calls; list_tickets returns its title and webUrl. The check itself is recorded in the app"
                    },
                    "overdueCount": {
                      "type": "number",
                      "description": "Of those, overdue"
                    },
                    "lastCompletedAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "openTicketCount": {
                      "type": "number",
                      "description": "Open run tickets"
                    },
                    "openTicketDueAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "openTicketStatus": {
                      "type": "string",
                      "description": "Run ticket status"
                    },
                    "lastCompletedAtIso": {
                      "type": "string",
                      "description": "When the last check was recorded, ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
                    },
                    "openTicketDueAtIso": {
                      "type": "string",
                      "description": "The run ticket's due date as a plain calendar day, \"YYYY-MM-DD\""
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Plan rows — plan CARDS in overview mode, this item's plans in itemId mode"
              },
              "counts": {
                "description": "Org-wide overdue / dueSoon / blocked counts — overview mode"
              },
              "needsAttention": {
                "description": "Rows blocked from scheduling — overview mode"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Maintenance status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "add_comment",
          "title": "Add comment",
          "description": "Leave a comment on exactly ONE of an item, a ticket or an order: exactly one of itemId / ticketId / orderId plus the text (\"note on the beamer: lamp flickers\"). The comment appears in that record's activity timeline under the connected user's name, marked \"(via AI agent)\", and notifies the people involved (item holder and responsible person, ticket reporter and assignee, order participants). Order comments require being an order participant (requester, assignee or an order manager). Plain text only: @-mentions are not supported. list_comments reads the thread back with the same one target id. Not idempotent: a repeated call posts a second comment.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "text"
            ],
            "properties": {
              "text": {
                "type": "string",
                "description": "The comment text (plain text)"
              },
              "itemId": {
                "type": "string",
                "description": "Item id (exactly one target)"
              },
              "orderId": {
                "type": "string",
                "description": "Order id (exactly one target)"
              },
              "ticketId": {
                "type": "string",
                "description": "Ticket id (exactly one target)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "target": {
                "type": "string",
                "description": "\"item\", \"ticket\" or \"order\""
              },
              "viaAgent": {
                "type": "boolean",
                "description": "True — the comment is marked as written via AI agent"
              },
              "commentId": {
                "type": "string",
                "description": "The new comment's id"
              },
              "authorName": {
                "type": "string",
                "description": "Whose name the comment carries"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Add comment",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_comments",
          "title": "List comments",
          "description": "Read the comments on exactly ONE of an item, a ticket or an order (the same one-target shape add_comment takes). Newest first, capped at 50 (`truncated` says the cap was hit). Each comment carries `authorName`, the `text`, `createdAt` with its UTC ISO twin `createdAtIso` (the server does no timezone conversion), and `editedAt` when it was changed after posting. `viaAgent: true` marks a comment an AI agent wrote on that person's behalf, including comments written through this connection; without it the person typed it themselves. The comments are the ones the connected user sees in the app: order comments require being an order participant (requester, assignee or an order manager).",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id (exactly one target)"
              },
              "orderId": {
                "type": "string",
                "description": "Order id (exactly one target), from list_orders"
              },
              "ticketId": {
                "type": "string",
                "description": "Ticket id (exactly one target), from list_tickets"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "target": {
                "type": "string",
                "description": "\"item\", \"ticket\" or \"order\""
              },
              "comments": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Comment id"
                    },
                    "text": {
                      "type": "string",
                      "description": "The comment text; @-mentions render as @Name"
                    },
                    "editedAt": {
                      "type": "number",
                      "description": "Epoch milliseconds — absent when never edited"
                    },
                    "viaAgent": {
                      "type": "boolean",
                      "description": "Present and true when an AI agent wrote it on that person's behalf. Absent = they typed it themselves"
                    },
                    "createdAt": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "authorName": {
                      "type": "string",
                      "description": "Who wrote it"
                    },
                    "editedAtIso": {
                      "type": "string",
                      "description": "When it was last edited, ISO-8601 UTC timestamp"
                    },
                    "createdAtIso": {
                      "type": "string",
                      "description": "When it was posted, ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The comments, newest first"
              },
              "truncated": {
                "type": "boolean",
                "description": "The 50-comment cap was hit — older comments exist in the app"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List comments",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_activity",
          "title": "List activity",
          "description": "The organization's audit trail: \"what changed on this item?\", \"what did somebody do last week?\", \"who moved this and when?\". Newest first, one merged feed over item, ticket and order events: assignments, moves, status and category changes, renames, quantity adjustments and stock moves, pack/unpack, code attach/detach, custom-field edits, ticket transitions and checklist results, order transitions. Filters: `itemId` (that one item's history), `actorUserId` (one person; ids from list_members), `sources` ([\"items\"], [\"tickets\"], [\"orders\"]), `types` (item event types) and a date window: `since` / `until` as calendar days (\"2026-08-01\"), `until` included. The server has no timezone and does no conversion; the legacy `dateFrom` / `dateTo` epochs still work, exactly one of each pair. Each row is one flat sentence: `atIso` when, `actorName` who (`viaAgent: true` = done through an AI agent), `type` what happened, `subject` what it happened to, `field` which attribute (the org's own label for a custom field), `from` / `to` the two ends of the change, `amount` where a number moved, and `webUrl`, the record's page in the web app. A row with `featureLocked: true` belongs to a module the organization's plan does not include (maintenance, orders): it is kept because history is a record, and it has no `webUrl`, since there is nothing to open. `limit` is 20 by default, max 50; `nextCursor` pages further back. The filters run after a page is cut, so a filtered page can be EMPTY while `isDone` is false: that page held no match, and older pages may; `isDone: true` means nothing older is left. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Rows per page, default 20, max 50"
              },
              "since": {
                "type": "string",
                "description": "Only events from this calendar day onward, \"YYYY-MM-DD\". The server has no timezone and does no conversion"
              },
              "types": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Only these ITEM event types — e.g. [\"assigned\", \"moved\", \"status_changed\", \"quantity_adjusted\", \"custom_field_changed\"]. An unknown value returns an error naming the whole valid set. Does not filter ticket or order rows"
              },
              "until": {
                "type": "string",
                "description": "Only events up to and INCLUDING this calendar day, \"YYYY-MM-DD\""
              },
              "cursor": {
                "type": "string",
                "description": "The `nextCursor` of a previous call; pages further back in time"
              },
              "dateTo": {
                "type": "number",
                "description": "Upper bound as epoch milliseconds (legacy form of `until`; exactly one of the two)"
              },
              "itemId": {
                "type": "string",
                "description": "Only this item's history (implies sources: [\"items\"])"
              },
              "sources": {
                "type": "array",
                "items": {
                  "enum": [
                    "items",
                    "tickets",
                    "orders"
                  ],
                  "type": "string"
                },
                "description": "Which records to read events from; absent = all three"
              },
              "dateFrom": {
                "type": "number",
                "description": "Lower bound as epoch milliseconds (legacy form of `since`; exactly one of the two)"
              },
              "actorUserId": {
                "type": "string",
                "description": "Only this person's actions: the userId from list_members"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "events": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "at": {
                      "type": "number",
                      "description": "Epoch milliseconds"
                    },
                    "to": {
                      "type": "string",
                      "description": "The value after, same rendering. Absent when it was cleared"
                    },
                    "from": {
                      "type": "string",
                      "description": "The value before, already rendered: a name, a status, a number, or a calendar day. Absent when there was none"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Which record the event belongs to: \"item\", \"ticket\" or \"order\""
                    },
                    "note": {
                      "type": "string",
                      "description": "The note the actor left, when any"
                    },
                    "type": {
                      "type": "string",
                      "description": "What happened: assigned | moved | status_changed | renamed | category_changed | quantity_adjusted | stock_moved | contained | removed | code_attached | custom_field_changed | ticket and order transitions | …"
                    },
                    "atIso": {
                      "type": "string",
                      "description": "When it happened, ISO-8601 UTC timestamp — read THIS one; the server does no timezone conversion"
                    },
                    "field": {
                      "type": "string",
                      "description": "Which attribute changed — the organization's own label for a custom field, the checklist line for a ticket check, the item name on an order line"
                    },
                    "amount": {
                      "type": "number",
                      "description": "How many moved — stock moves and order lines"
                    },
                    "itemId": {
                      "type": "string",
                      "description": "Item id — for follow-up calls"
                    },
                    "webUrl": {
                      "type": "string",
                      "description": "Link to the record in the web app, for a person to open; the ids are handles for tool calls. Absent on featureLocked rows, which have nowhere to link to"
                    },
                    "orderId": {
                      "type": "string",
                      "description": "Order id — for follow-up calls"
                    },
                    "subject": {
                      "type": "string",
                      "description": "What it happened to: the item or model name, the ticket title, or the order's request text. \"—\" when the record has since been deleted (the row is kept — an audit trail must not lie by omission)"
                    },
                    "ticketId": {
                      "type": "string",
                      "description": "Ticket id — for follow-up calls"
                    },
                    "viaAgent": {
                      "type": "boolean",
                      "description": "Present and true when they did it through an AI agent. Absent = they did it themselves in the app"
                    },
                    "actorName": {
                      "type": "string",
                      "description": "Who did it"
                    },
                    "primaryCode": {
                      "type": "string",
                      "description": "The item's printed asset code"
                    },
                    "featureLocked": {
                      "type": "boolean",
                      "description": "Present and true when this event belongs to a module the organization's plan does not include (e.g. maintenance or orders). The row is shown because history is a record, but it carries NO webUrl: there is nothing to open. Absent = a normal row"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The trail, newest first"
              },
              "isDone": {
                "type": "boolean",
                "description": "True = this was the last page; there is nothing older to fetch. An EMPTY `events` array while this is false is normal on a filtered read — the filters are applied after the page is cut, so that page simply held no matching rows, and older pages (`nextCursor`) may"
              },
              "nextCursor": {
                "type": "string",
                "description": "The `cursor` value for the next page further back in time. Present only while isDone is false"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List activity",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "adjust_stock",
          "title": "Adjust stock",
          "description": "Correct a quantity-tracked item's stock at ONE location: \"we used up 12 batteries\", \"50 arrived\", \"recounted: there are 7\". Exactly one of delta (relative: negative = used up, positive = received) or setTo (absolute recount). kind states the intent (usage | receipt | correction; inferred from the argument shape when absent); reason is a short note for the activity timeline. A negative delta past the location's unreserved stock is rejected (the error names the amounts); a setTo recount always records the count, even below reservations. A restock task opens automatically when a location's AVAILABLE stock (on hand minus what active orders reserved) drops below its threshold, so a location can be low with a full shelf. The result returns every stocked level as distribution: { locationId, name, kind: location|person, quantity, available, reserved?, minStock?, isLow? }, the same row shape check_item_availability returns, so isLow shows whether this adjustment took the location under its threshold. transfer_stock moves stock between locations; serialized items change through assign_item and set_item_status. Requires the manager role. Not idempotent: a repeated delta applies twice (a repeated setTo does not change the count again).",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId",
              "locationId"
            ],
            "properties": {
              "kind": {
                "enum": [
                  "usage",
                  "receipt",
                  "correction"
                ],
                "type": "string",
                "description": "Intent for the activity timeline; inferred from the argument shape when absent"
              },
              "delta": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Relative change: negative = used up, positive = received (exactly one of delta/setTo)"
              },
              "setTo": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Absolute recount — the new quantity at this location"
              },
              "itemId": {
                "type": "string",
                "description": "Item id (must be a quantity-tracked item)"
              },
              "reason": {
                "type": "string",
                "description": "Short reason, shown in the item's activity timeline"
              },
              "locationId": {
                "type": "string",
                "description": "Location (or stock-holding person) resource id, from search_resources or check_item_availability's distribution"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "distribution": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "\"location\" or \"person\" (a person holding pool stock)"
                    },
                    "name": {
                      "type": "string",
                      "description": "Location or person name"
                    },
                    "isLow": {
                      "type": "boolean",
                      "description": "True when available < minStock. Present only alongside minStock — absent means no threshold is set here, NOT that the level is healthy"
                    },
                    "minStock": {
                      "type": "number",
                      "description": "Restock threshold here (absent when none is set)"
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Physical stock on hand here"
                    },
                    "reserved": {
                      "type": "number",
                      "description": "Of that, promised to active orders (absent when 0)"
                    },
                    "available": {
                      "type": "number",
                      "description": "Freely usable stock: quantity minus reserved, floored at 0. Always present"
                    },
                    "locationId": {
                      "type": "string",
                      "description": "Resource id of this place — pass it straight to adjust_stock, set_min_stock or transfer_stock (no search_resources round-trip needed)"
                    },
                    "locationName": {
                      "type": "string",
                      "description": "DEPRECATED — the same string as `name`, kept only for clients whose tool list froze before the rename"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Every stocked level after the change — the SAME row shape check_item_availability returns"
              },
              "totalQuantity": {
                "type": "number",
                "description": "Pool total after the change"
              },
              "newLevelQuantity": {
                "type": "number",
                "description": "The adjusted location's stock after the change"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Adjust stock",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "set_min_stock",
          "title": "Set restock threshold",
          "description": "Set or clear the restock threshold (minimum stock) for a quantity-tracked item at ONE location: \"alert us when Room 201 drops below 5\". Thresholds are per item PER LOCATION, so locationId is required alongside itemId: every row of check_item_availability's distribution carries the locationId of a level that stocks the item, and search_resources (type: \"location\") returns the id of a location that does not stock it yet. minStock is a number, or null to clear the threshold. \"Low\" is measured against AVAILABLE stock, the shelf count MINUS what active orders reserved: 14 on hand with 10 reserved against a threshold of 5 IS low (4 available); check_item_availability reports that verdict per level as isLow. While the location is low a restock task is open for the order handlers; raising, lowering or clearing the threshold re-evaluates it immediately. Person-held stock cannot carry a threshold. Requires the manager role. Idempotent: the same value again changes nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId",
              "locationId",
              "minStock"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "description": "Item id (must be a quantity-tracked item)"
              },
              "minStock": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The threshold, or null to clear it"
              },
              "locationId": {
                "type": "string",
                "description": "Location resource id, from check_item_availability's distribution or search_resources"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Item name"
              },
              "itemId": {
                "type": "string",
                "description": "Item id"
              },
              "minStock": {
                "type": "number",
                "description": "The threshold now in force (absent = cleared)"
              },
              "quantity": {
                "type": "number",
                "description": "Stock on hand at that location"
              },
              "locationId": {
                "type": "string",
                "description": "Location resource id"
              },
              "locationName": {
                "type": "string",
                "description": "Location name"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Set restock threshold",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "create_team",
          "title": "Create team",
          "description": "Create an assignment team: a named group of members that tickets and orders can be assigned to (\"create a facilities team\"). Team members see assigned team work in their tasks; the first to act takes it over. add_team_member adds members (userIds from list_members). Admin only. Not idempotent: a repeated call creates a same-name twin.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Team name"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "description": "Team name as stored (trimmed)"
              },
              "teamId": {
                "type": "string",
                "description": "The new team's id"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create team",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "add_team_member",
          "title": "Add team member",
          "description": "Add an organization member to a team. userId is the member's userId from list_members, NOT a person-resource id from search_resources; teamId comes from list_teams or create_team. Idempotent: re-adding an existing member changes nothing. A full team is refused with teamMemberCap, which carries the cap. Admin only.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "teamId",
              "userId"
            ],
            "properties": {
              "teamId": {
                "type": "string",
                "description": "Team id (from list_teams or create_team)"
              },
              "userId": {
                "type": "string",
                "description": "Member userId (from list_members)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "teamId": {
                "type": "string",
                "description": "Team id"
              },
              "userId": {
                "type": "string",
                "description": "The member userId that was added"
              },
              "teamName": {
                "type": "string",
                "description": "Team name"
              },
              "memberCount": {
                "type": "number",
                "description": "Members in the team afterwards"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Add team member",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_teams",
          "title": "List teams",
          "description": "The organization's teams with member counts: each team's `name` and its `id`, the teamId add_team_member takes (\"which teams do we have?\"). Any member may read; team membership details are on the app's Members page.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "teams": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Team id"
                    },
                    "name": {
                      "type": "string",
                      "description": "Team name"
                    },
                    "memberCount": {
                      "type": "number",
                      "description": "Members in the team"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The organization's teams"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List teams",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_setup_template",
          "title": "Get setup template",
          "description": "Starting templates for setting up an organization's inventory: per kind of organization a category tree with custom field definitions, typical locations, quantity-tracked consumable examples, naming conventions and the questions that shape a setup. Without arguments: the template catalog (id, title, org-type fit, summary). With templateId: the full template, whose structured slices match the scaffold_categories / scaffold_locations inputs, with names as {en, de, fr, es, it} records. Pure product data: it reads nothing from the organization and writes nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "templateId": {
                "type": "string",
                "description": "Template id from the catalog (absent = the catalog of all templates)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "id": {
                "type": "string",
                "description": "Template id — templateId mode"
              },
              "title": {
                "description": "{ en, de, fr, es, it } title"
              },
              "summary": {
                "type": "string",
                "description": "One-line summary"
              },
              "version": {
                "type": "string",
                "description": "Template version"
              },
              "guidance": {
                "description": "Interview hints: the questions that shape a setup, and notes on the template"
              },
              "orgTypes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Kinds of organization it fits"
              },
              "locations": {
                "description": "Location slice, shaped like scaffold_locations' input"
              },
              "templates": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Template id"
                    },
                    "title": {
                      "description": "{ en, de, fr, es, it } title"
                    },
                    "summary": {
                      "type": "string",
                      "description": "One-line summary"
                    },
                    "version": {
                      "type": "string",
                      "description": "Template version"
                    },
                    "orgTypes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Kinds of organization this template fits"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The catalog — no-argument mode"
              },
              "categories": {
                "description": "Category slice, shaped like scaffold_categories' input"
              },
              "howToChoose": {
                "type": "string",
                "description": "How to pick — no-argument mode"
              },
              "instruction": {
                "type": "string",
                "description": "How to adapt and commit the template"
              },
              "orgWideFields": {
                "description": "Fields every item should carry"
              },
              "quantityExamples": {
                "description": "Typical consumables to create with trackingMode \"quantity\""
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Get setup template",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "plan_import",
          "title": "Plan an import (dry run)",
          "description": "Dry-run an import of a whole list with the product's own importer (the same one the app's import screen uses); it writes NOTHING. Arguments: the data rows (cells as strings, header row left out) and one `columns` entry per cell position with its target: name, description, category, homeLocation, currentLocation, responsiblePerson, currentHolder, blueprintName (an item model, by name), container (the item this row's item sits in: a vehicle, case or cart, named by the name or code of ANOTHER ROW of this file or of an existing item; a vehicle is an item with its own row, never a location), compartment (its compartment, e.g. «GR1», «Fahrerhaus»; created on the container when missing), code (a printed code or serial, the lasting way to tell identical pieces apart), quantity / minStock (stock items), trackingMode (quantity, menge, stückzahl, stueckzahl, bestand, pool (stock: a count of identical pieces) or serialized, serialisiert, einzeln, einzelstück, einzelstueck, unit (single pieces); a quantity or minStock value alone already makes a stock item), status, a fieldDefId from get_item_requirements or \"field:<label>\"; null skips a column. Categories and locations are matched by name, paths split by `separator` (\"Fahrzeuge/Anhänger\"); a name that matches nothing is listed under toCreate and would be created by the import itself (a typo shows up there too). scaffold_categories creates categories and typed fields beforehand, scaffold_models item models. Dates as \"YYYY-MM-DD\" or \"DD.MM.YYYY\" only: other forms are dropped (see problems). Rows without a code are matched to existing items BY NAME, so every code-less name must be unique in the file, one stock article in several places aside (e.g. «Helm TLF», «Helm KLF» for two helmets). Single items are packed into their container; a stock row's count goes into it. One stock article in several places: one row per place, all with the SAME name (and the same code, if it has one), each with its own container, compartment and count; at most one of them without a container, whose count is the stock at the item's home. They become ONE stock item: the dry run shows the row without a container (else the first) as create and the others as place, and lists each article's places and total under stockGroups. Identical single pieces are not grouped: each needs its own name or code. The result says per row what would be created, updated or skipped, every value that would be dropped and why, what would be placed in which container and compartment and which compartments would be created, blockers that must be fixed first, columns the organization's plan cannot import, and whether the import lands past the plan's item allowance (allowed once: after that no published item can be added until the organization upgrades). It returns a planHash, which run_import takes with the same arguments. At most 1000 rows per call; the app's import screen takes longer lists as a CSV file. entity \"persons\" or \"locations\" imports people or places instead (targets: name, parentPath, email). Any member can plan; running needs the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "fileName",
              "columns",
              "rows"
            ],
            "properties": {
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "description": "The data rows of the source file, cells as strings, header row left out. At most 1000 rows per call"
              },
              "entity": {
                "enum": [
                  "items",
                  "persons",
                  "locations"
                ],
                "type": "string",
                "description": "What the rows are: \"items\" (default), \"persons\" (people) or \"locations\" (places)"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "header",
                    "target"
                  ],
                  "properties": {
                    "header": {
                      "type": "string",
                      "description": "The column's header as in the file"
                    },
                    "target": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Import target (see the tool description), a field definition id, \"field:<label>\", or null to skip the column"
                    }
                  }
                },
                "description": "One entry per cell position of a row, in the same order"
              },
              "fileName": {
                "type": "string",
                "description": "The source file's name (shown in the app's import history), e.g. Inventar 2024.xlsx"
              },
              "keepOrder": {
                "type": "boolean",
                "description": "Items are imported last row first by default, so the file's first row is the newest item and the app's list opens on it; true keeps the file order"
              },
              "separator": {
                "type": "string",
                "description": "Path separator in category and location cells (default \"/\": \"Fahrzeuge/Anhänger\")"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "next": {
                "type": "string"
              },
              "rows": {
                "type": "number",
                "description": "Rows sent"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Notes on the plan's outcome"
              },
              "order": {
                "type": "string",
                "description": "reversed (default for items: the first row becomes the newest item, so the app's list opens on it) or \"file\" (keepOrder)"
              },
              "entity": {
                "type": "string"
              },
              "mapping": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "target": {
                      "type": "string"
                    },
                    "fieldLabel": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The columns that import, resolved"
              },
              "refused": {
                "type": "string",
                "description": "Set when the call was refused and nothing was written: tooManyRows, tooManyColumns, blockers, batchUndone"
              },
              "summary": {
                "type": "object",
                "properties": {
                  "ok": {
                    "type": "number"
                  },
                  "skip": {
                    "type": "number"
                  },
                  "place": {
                    "type": "number"
                  },
                  "create": {
                    "type": "number"
                  },
                  "errors": {
                    "type": "number"
                  },
                  "update": {
                    "type": "number"
                  },
                  "warnings": {
                    "type": "number"
                  }
                },
                "description": "Rows by outcome: create / update / skip / place (adds stock in a place to another row's item, see stockGroups), and by status: ok / warnings (the row imports, a value is dropped) / errors (the row is skipped)",
                "additionalProperties": {}
              },
              "blockers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "duplicateNameWithoutCode, duplicateCode, placementGroupTooLarge, duplicateUniqueValue, unknownField, ambiguousField, unknownTarget, duplicateTarget, noNameColumn, noCategoryColumn, rowTooWide, noRows, overCap"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      },
                      "description": "1-based positions in the rows passed"
                    },
                    "detail": {
                      "type": "string",
                      "description": "What is wrong and how to fix it"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "What run_import refuses until it is fixed. Empty = none"
              },
              "capacity": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "used": {
                        "type": "number"
                      },
                      "allowance": {
                        "type": "number"
                      },
                      "itemsAfter": {
                        "type": "number"
                      },
                      "landsPastCap": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The plan's item allowance; null = no allowance"
              },
              "fileName": {
                "type": "string"
              },
              "planHash": {
                "type": "string",
                "description": "run_import takes it with the SAME arguments; it changes when the rows or the organization's answers change"
              },
              "problems": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "type": "number",
                      "description": "1-based position in the rows passed"
                    },
                    "name": {
                      "type": "string"
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "description": "The importer's issue code, e.g. invalidValue (the value is dropped), missingCategory (row skipped), containerNotFound (the row imports unplaced)"
                          },
                          "value": {
                            "type": "string",
                            "description": "The cell as sent"
                          },
                          "column": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      }
                    },
                    "status": {
                      "type": "string"
                    },
                    "disposition": {
                      "type": "string"
                    },
                    "matchedItemId": {
                      "type": "string"
                    },
                    "placesIntoRow": {
                      "type": "number",
                      "description": "A stock article's row: the 1-based row of the item it adds its count to"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Every row that does not simply create an item cleanly: dropped values, skipped rows, updates of existing items"
              },
              "toCreate": {
                "type": "object",
                "properties": {
                  "models": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "locations": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "resources": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "categories": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "compartments": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "«Container › compartment» per compartment the import adds"
                  }
                },
                "description": "What the import itself would create by name — usually a typo when the structure was created first",
                "additionalProperties": {}
              },
              "placements": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "container": {
                      "type": "string",
                      "description": "The container's name"
                    },
                    "stockRows": {
                      "type": "number"
                    },
                    "singleItems": {
                      "type": "number"
                    },
                    "stockPieces": {
                      "type": "number"
                    },
                    "existingItemId": {
                      "type": "string",
                      "description": "Set when the container is an existing item"
                    },
                    "compartmentsToCreate": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Compartments the import adds to it, in the file's order"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Only with a container column: per container, the single items packed into it and the stock counts that go into it"
              },
              "planChanged": {
                "type": "boolean",
                "description": "run_import only: nothing was written, the plan changed"
              },
              "stockGroups": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "type": "number",
                      "description": "1-based position of the row that defines the item"
                    },
                    "code": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "places": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pieces": {
                            "type": "number"
                          },
                          "container": {
                            "type": "string"
                          },
                          "compartment": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      }
                    },
                    "homePieces": {
                      "type": "number",
                      "description": "Pieces at the item's home location"
                    },
                    "totalPieces": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Only with a container column: each stock article whose rows (one per place, same name and code) become ONE stock item — its total, the pieces at home and per place"
              },
              "problemsShown": {
                "type": "number"
              },
              "problemsTotal": {
                "type": "number"
              },
              "stockGroupsTotal": {
                "type": "number"
              },
              "columnsNotImported": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": {}
                },
                "description": "Mapped columns the organization's plan cannot import"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Plan an import (dry run)",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "run_import",
          "title": "Run an import",
          "description": "Run an import: the SAME arguments as plan_import, plus its planHash and a clientRequestId (e.g. a UUID). Everything lands in ONE import batch. If anything changed since the plan (the rows, or the organization now answers differently) it returns planChanged with the new outcome and writes nothing. A large list can return done: false; the same call with the same arguments and clientRequestId continues where it stopped and never duplicates. clientRequestId identifies the batch: the same id continues it, a new id starts a new batch (still checked against planHash). With a container column, the answer repeats the placements and the stock groups. Every created item's history shows the connected user's name with \"(via AI agent)\"; the import appears in the app's import history (webUrl), where it can be undone. Requires the manager role.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "fileName",
              "columns",
              "rows",
              "planHash",
              "clientRequestId"
            ],
            "properties": {
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "description": "The data rows of the source file, cells as strings, header row left out. At most 1000 rows per call"
              },
              "entity": {
                "enum": [
                  "items",
                  "persons",
                  "locations"
                ],
                "type": "string",
                "description": "What the rows are: \"items\" (default), \"persons\" (people) or \"locations\" (places)"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "header",
                    "target"
                  ],
                  "properties": {
                    "header": {
                      "type": "string",
                      "description": "The column's header as in the file"
                    },
                    "target": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Import target (see the tool description), a field definition id, \"field:<label>\", or null to skip the column"
                    }
                  }
                },
                "description": "One entry per cell position of a row, in the same order"
              },
              "fileName": {
                "type": "string",
                "description": "The source file's name (shown in the app's import history), e.g. Inventar 2024.xlsx"
              },
              "planHash": {
                "type": "string",
                "description": "The planHash plan_import returned for these arguments"
              },
              "keepOrder": {
                "type": "boolean",
                "description": "Items are imported last row first by default, so the file's first row is the newest item and the app's list opens on it; true keeps the file order"
              },
              "separator": {
                "type": "string",
                "description": "Path separator in category and location cells (default \"/\": \"Fahrzeuge/Anhänger\")"
              },
              "clientRequestId": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "One id per import batch (e.g. a UUID); the same id continues a run that answered done: false"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "done": {
                "type": "boolean",
                "description": "false: the run stopped early; the same call with the same arguments and clientRequestId continues it"
              },
              "next": {
                "type": "string"
              },
              "rows": {
                "type": "number",
                "description": "Rows sent"
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Notes on the plan's outcome"
              },
              "order": {
                "type": "string",
                "description": "reversed (default for items: the first row becomes the newest item, so the app's list opens on it) or \"file\" (keepOrder)"
              },
              "entity": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "webUrl": {
                "type": "string",
                "description": "The app's import history, where the import can also be undone"
              },
              "mapping": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "target": {
                      "type": "string"
                    },
                    "fieldLabel": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The columns that import, resolved"
              },
              "refused": {
                "type": "string",
                "description": "Set when the call was refused and nothing was written: tooManyRows, tooManyColumns, blockers, batchUndone"
              },
              "summary": {
                "type": "object",
                "properties": {
                  "ok": {
                    "type": "number"
                  },
                  "skip": {
                    "type": "number"
                  },
                  "place": {
                    "type": "number"
                  },
                  "create": {
                    "type": "number"
                  },
                  "errors": {
                    "type": "number"
                  },
                  "update": {
                    "type": "number"
                  },
                  "warnings": {
                    "type": "number"
                  }
                },
                "description": "Rows by outcome: create / update / skip / place (adds stock in a place to another row's item, see stockGroups), and by status: ok / warnings (the row imports, a value is dropped) / errors (the row is skipped)",
                "additionalProperties": {}
              },
              "blockers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "duplicateNameWithoutCode, duplicateCode, placementGroupTooLarge, duplicateUniqueValue, unknownField, ambiguousField, unknownTarget, duplicateTarget, noNameColumn, noCategoryColumn, rowTooWide, noRows, overCap"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      },
                      "description": "1-based positions in the rows passed"
                    },
                    "detail": {
                      "type": "string",
                      "description": "What is wrong and how to fix it"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "What run_import refuses until it is fixed. Empty = none"
              },
              "capacity": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "used": {
                        "type": "number"
                      },
                      "allowance": {
                        "type": "number"
                      },
                      "itemsAfter": {
                        "type": "number"
                      },
                      "landsPastCap": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The plan's item allowance; null = no allowance"
              },
              "fileName": {
                "type": "string"
              },
              "planHash": {
                "type": "string",
                "description": "run_import takes it with the SAME arguments; it changes when the rows or the organization's answers change"
              },
              "problems": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "type": "number",
                      "description": "1-based position in the rows passed"
                    },
                    "name": {
                      "type": "string"
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "description": "The importer's issue code, e.g. invalidValue (the value is dropped), missingCategory (row skipped), containerNotFound (the row imports unplaced)"
                          },
                          "value": {
                            "type": "string",
                            "description": "The cell as sent"
                          },
                          "column": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      }
                    },
                    "status": {
                      "type": "string"
                    },
                    "disposition": {
                      "type": "string"
                    },
                    "matchedItemId": {
                      "type": "string"
                    },
                    "placesIntoRow": {
                      "type": "number",
                      "description": "A stock article's row: the 1-based row of the item it adds its count to"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Every row that does not simply create an item cleanly: dropped values, skipped rows, updates of existing items"
              },
              "thisCall": {
                "type": "object",
                "properties": {
                  "placed": {
                    "type": "number",
                    "description": "Rows that added stock in a place to another row's item"
                  },
                  "created": {
                    "type": "number"
                  },
                  "updated": {
                    "type": "number"
                  }
                },
                "additionalProperties": {}
              },
              "toCreate": {
                "type": "object",
                "properties": {
                  "models": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "locations": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "resources": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "categories": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "compartments": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "«Container › compartment» per compartment the import adds"
                  }
                },
                "description": "What the import itself would create by name — usually a typo when the structure was created first",
                "additionalProperties": {}
              },
              "totalRows": {
                "type": "number"
              },
              "placements": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "container": {
                      "type": "string",
                      "description": "The container's name"
                    },
                    "stockRows": {
                      "type": "number"
                    },
                    "singleItems": {
                      "type": "number"
                    },
                    "stockPieces": {
                      "type": "number"
                    },
                    "existingItemId": {
                      "type": "string",
                      "description": "Set when the container is an existing item"
                    },
                    "compartmentsToCreate": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Compartments the import adds to it, in the file's order"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Only with a container column: per container, the single items packed into it and the stock counts that go into it"
              },
              "planChanged": {
                "type": "boolean",
                "description": "run_import only: nothing was written, the plan changed"
              },
              "stockGroups": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "type": "number",
                      "description": "1-based position of the row that defines the item"
                    },
                    "code": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "places": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pieces": {
                            "type": "number"
                          },
                          "container": {
                            "type": "string"
                          },
                          "compartment": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      }
                    },
                    "homePieces": {
                      "type": "number",
                      "description": "Pieces at the item's home location"
                    },
                    "totalPieces": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Only with a container column: each stock article whose rows (one per place, same name and code) become ONE stock item — its total, the pieces at home and per place"
              },
              "committedRows": {
                "type": "number"
              },
              "importBatchId": {
                "type": "string"
              },
              "problemsShown": {
                "type": "number"
              },
              "problemsTotal": {
                "type": "number"
              },
              "stockGroupsTotal": {
                "type": "number"
              },
              "columnsNotImported": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": {}
                },
                "description": "Mapped columns the organization's plan cannot import"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Run an import",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "check_fit",
          "title": "Check whether Mango Inventory fits",
          "description": "Whether Mango Inventory fits an organization. Works without an account. Takes what is known: the kind of organization, about how many items and people, the needs as keys from the list, and other needs as free text. The answer says what is covered (each with its help page), what is not built and what exists instead, notes about size, the monthly price of the plan that covers the needs when itemCount is given, and the next step.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "needs": {
                "type": "array",
                "items": {
                  "enum": [
                    "items_fields",
                    "item_models",
                    "qr_labels_scanning",
                    "checkout_return",
                    "people_places",
                    "containers",
                    "kit_lists",
                    "quantities_stock",
                    "orders_reservations",
                    "defects_tickets",
                    "maintenance_inspections",
                    "stocktaking",
                    "history",
                    "receipt_confirmation",
                    "import_export",
                    "single_sign_on",
                    "directory_sync",
                    "roles_permissions",
                    "mobile_app",
                    "notifications",
                    "languages",
                    "ai_assistant",
                    "offline",
                    "gps_tracking",
                    "erp_accounting_sync",
                    "signatures",
                    "wash_cycles",
                    "key_cabinet",
                    "selling_goods"
                  ],
                  "type": "string"
                },
                "maxItems": 60,
                "description": "The needs, as keys from this list (keys of things that are not built are valid; the answer says which are not): items_fields = Items with categories and their own fields; item_models = Item models: many pieces of one article, with sizes or variants; qr_labels_scanning = Printable QR labels and scanning with the phone; checkout_return = Check-out and return to people, places or teams; people_places = People, rooms, buildings, sites and teams; containers = Containers: vehicles, cases, carts and their contents; kit_lists = Kit lists: what belongs in a vehicle, case or bag; quantities_stock = Consumables and stock counted in quantities, with minimum levels; orders_reservations = Orders and reservations: people request items, someone hands them out; defects_tickets = Defect reports and tickets; maintenance_inspections = Maintenance and safety inspections on a schedule, with checklists; stocktaking = Stocktaking: counting everything by scan; history = History: who had what, and when; receipt_confirmation = Receipt confirmation: the person confirms they received an item; import_export = Import from Excel or CSV, export to Excel, CSV or a ZIP; single_sign_on = Single sign-on with Microsoft or Google; directory_sync = Directory sync: people and groups from Microsoft Entra or Google Workspace; roles_permissions = Fine-grained roles and field visibility for larger teams; mobile_app = An app for the phone; notifications = Notifications by email and on the phone; languages = The app in German, English, French, Italian or Spanish; ai_assistant = Working through an AI assistant (ChatGPT, Claude, Copilot or another MCP client); offline = Working without an internet connection; gps_tracking = GPS or live location tracking; erp_accounting_sync = A link to an ERP, accounting or other business system; signatures = Signatures on hand-over; wash_cycles = Counting wash cycles of textiles; key_cabinet = Key management with a key cabinet or locking plan; selling_goods = Stock of goods you sell: a shop, sales or invoicing."
              },
              "people": {
                "type": "integer",
                "maximum": 10000000,
                "minimum": 0,
                "description": "About how many people will use it or hold items."
              },
              "orgType": {
                "enum": [
                  "school",
                  "company",
                  "publicAdmin",
                  "publicWorks",
                  "club",
                  "other"
                ],
                "type": "string",
                "description": "school, company, publicAdmin (public administration), publicWorks (public works, utilities, fire brigades), club, or other."
              },
              "language": {
                "enum": [
                  "en",
                  "de",
                  "fr",
                  "it",
                  "es"
                ],
                "type": "string",
                "description": "Language of the help-page links: en (default), de, fr, it or es."
              },
              "itemCount": {
                "type": "integer",
                "maximum": 10000000,
                "minimum": 0,
                "description": "About how many things they want to track. Each piece counts once; a stock of identical consumables tracked as a quantity counts as one item."
              },
              "otherNeeds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 4000
                },
                "maxItems": 20,
                "description": "Needs that fit no key, in the user's words, without names: up to 5, each up to 200 characters. The team reads them."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "quote": {
                "type": "object",
                "properties": {
                  "why": {
                    "type": "string"
                  },
                  "plan": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "blocks": {
                        "type": "number"
                      },
                      "includes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "itemsCovered": {
                        "type": "number"
                      },
                      "monthlyPrice": {
                        "type": "number",
                        "description": "Per month for itemsCovered items"
                      },
                      "pricePerBlock": {
                        "type": "number"
                      }
                    },
                    "description": "The plan that covers every need asked for",
                    "additionalProperties": {}
                  },
                  "notes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "currency": {
                    "type": "string"
                  },
                  "nextPlan": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "adds": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "name": {
                        "type": "string"
                      },
                      "monthlyPrice": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "nextStep": {
                    "type": "string",
                    "description": "The next step the answer offers"
                  },
                  "freeToTry": {
                    "type": "boolean",
                    "description": "True when the inventory fits the free 50 items to try"
                  },
                  "itemCount": {
                    "type": "number"
                  }
                },
                "additionalProperties": {}
              },
              "bestFor": {
                "type": "string"
              },
              "matched": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "need": {
                      "type": "string"
                    },
                    "helpUrl": {
                      "type": "string"
                    },
                    "statement": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Needs Mango Inventory covers, each with the help page"
              },
              "summary": {
                "type": "string"
              },
              "verdict": {
                "type": "string",
                "description": "goodFit · fitsWithNotes · askUs · notChecked (no needs were given)"
              },
              "nextStep": {
                "type": "string",
                "description": "The next step the answer offers"
              },
              "notBuilt": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "need": {
                      "type": "string"
                    },
                    "helpUrl": {
                      "type": "string"
                    },
                    "instead": {
                      "type": "string"
                    },
                    "statement": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "Needs that are not built, and what exists instead"
              },
              "otherNeeds": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "answer": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                }
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Check whether Mango Inventory fits",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "quote",
          "title": "Price for Mango Inventory",
          "description": "The price of Mango Inventory. Works without an account. Takes how many items will be tracked and, optionally, the needs (the same keys as check_fit) and a currency. The answer names the plan that covers the needs, its monthly price for that many items, what the next plan adds, and whether the inventory fits the 50 items that are free to try. The server computes every number from the current price list.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemCount"
            ],
            "properties": {
              "needs": {
                "type": "array",
                "items": {
                  "enum": [
                    "items_fields",
                    "item_models",
                    "qr_labels_scanning",
                    "checkout_return",
                    "people_places",
                    "containers",
                    "kit_lists",
                    "quantities_stock",
                    "orders_reservations",
                    "defects_tickets",
                    "maintenance_inspections",
                    "stocktaking",
                    "history",
                    "receipt_confirmation",
                    "import_export",
                    "single_sign_on",
                    "directory_sync",
                    "roles_permissions",
                    "mobile_app",
                    "notifications",
                    "languages",
                    "ai_assistant",
                    "offline",
                    "gps_tracking",
                    "erp_accounting_sync",
                    "signatures",
                    "wash_cycles",
                    "key_cabinet",
                    "selling_goods"
                  ],
                  "type": "string"
                },
                "maxItems": 60,
                "description": "The needs, as keys from this list (keys of things that are not built are valid; the answer says which are not): items_fields = Items with categories and their own fields; item_models = Item models: many pieces of one article, with sizes or variants; qr_labels_scanning = Printable QR labels and scanning with the phone; checkout_return = Check-out and return to people, places or teams; people_places = People, rooms, buildings, sites and teams; containers = Containers: vehicles, cases, carts and their contents; kit_lists = Kit lists: what belongs in a vehicle, case or bag; quantities_stock = Consumables and stock counted in quantities, with minimum levels; orders_reservations = Orders and reservations: people request items, someone hands them out; defects_tickets = Defect reports and tickets; maintenance_inspections = Maintenance and safety inspections on a schedule, with checklists; stocktaking = Stocktaking: counting everything by scan; history = History: who had what, and when; receipt_confirmation = Receipt confirmation: the person confirms they received an item; import_export = Import from Excel or CSV, export to Excel, CSV or a ZIP; single_sign_on = Single sign-on with Microsoft or Google; directory_sync = Directory sync: people and groups from Microsoft Entra or Google Workspace; roles_permissions = Fine-grained roles and field visibility for larger teams; mobile_app = An app for the phone; notifications = Notifications by email and on the phone; languages = The app in German, English, French, Italian or Spanish; ai_assistant = Working through an AI assistant (ChatGPT, Claude, Copilot or another MCP client); offline = Working without an internet connection; gps_tracking = GPS or live location tracking; erp_accounting_sync = A link to an ERP, accounting or other business system; signatures = Signatures on hand-over; wash_cycles = Counting wash cycles of textiles; key_cabinet = Key management with a key cabinet or locking plan; selling_goods = Stock of goods you sell: a shop, sales or invoicing."
              },
              "currency": {
                "enum": [
                  "chf",
                  "eur",
                  "gbp",
                  "usd"
                ],
                "type": "string",
                "description": "chf (default), eur, gbp or usd. The four have the same numbers."
              },
              "itemCount": {
                "type": "integer",
                "maximum": 10000000,
                "minimum": 0,
                "description": "How many things they want to track. Each piece counts once; a stock of identical consumables tracked as a quantity counts as one item."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "why": {
                "type": "string"
              },
              "plan": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "blocks": {
                    "type": "number"
                  },
                  "includes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "itemsCovered": {
                    "type": "number"
                  },
                  "monthlyPrice": {
                    "type": "number",
                    "description": "Per month for itemsCovered items"
                  },
                  "pricePerBlock": {
                    "type": "number"
                  }
                },
                "description": "The plan that covers every need asked for",
                "additionalProperties": {}
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "currency": {
                "type": "string"
              },
              "nextPlan": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "adds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "name": {
                    "type": "string"
                  },
                  "monthlyPrice": {
                    "type": "number"
                  }
                },
                "additionalProperties": {}
              },
              "nextStep": {
                "type": "string",
                "description": "The next step the answer offers"
              },
              "freeToTry": {
                "type": "boolean",
                "description": "True when the inventory fits the free 50 items to try"
              },
              "itemCount": {
                "type": "number"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Price for Mango Inventory",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "find_docs",
          "title": "Find a help page",
          "description": "Find the Mango Inventory help pages that answer a question. Works without an account. Takes the question in a few words (in any of the help languages or in English) and the language for the links. Returns up to five help pages with the section that matched.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "question"
            ],
            "properties": {
              "language": {
                "enum": [
                  "en",
                  "de",
                  "fr",
                  "it",
                  "es"
                ],
                "type": "string",
                "description": "Language of the help-page links: en (default), de, fr, it or es."
              },
              "question": {
                "type": "string",
                "maxLength": 300,
                "minLength": 1,
                "description": "The question in a few words, e.g. \"vans with their equipment\" or \"safety inspections\". Up to 300 characters."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string"
              },
              "pages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "section": {
                      "type": "string",
                      "description": "The heading on that page that matched"
                    },
                    "description": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                }
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Find a help page",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tell_us",
          "title": "Message the Mango Inventory team",
          "description": "Pass a message to the Mango Inventory team: what a visitor came for, or what is missing. Works without an account; signed-in connections have send_feedback. Takes the need in a few words, what was missing, the outcome and, with source \"user\", the user's own words. The text is stored for the team as written, with Mango Inventory keys and tokens redacted and control characters stripped; over the public rate limits a message is answered as received but not stored. Answers { received: true } with a short note. Not idempotent: each call is a new message.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "lookingFor"
            ],
            "properties": {
              "model": {
                "type": "string",
                "maxLength": 4000,
                "description": "The AI model sending it, if known. Up to 80 characters."
              },
              "source": {
                "enum": [
                  "agent",
                  "user"
                ],
                "type": "string",
                "description": "agent (default) = the agent's own summary; user = the user asked for it to be passed on."
              },
              "missing": {
                "type": "string",
                "maxLength": 4000,
                "description": "What was missing or unclear for them. Up to 1000 characters."
              },
              "outcome": {
                "enum": [
                  "foundIt",
                  "partly",
                  "notHere"
                ],
                "type": "string",
                "description": "foundIt = Mango Inventory covers it; partly = some of it; notHere = it does not."
              },
              "userWords": {
                "type": "string",
                "maxLength": 4000,
                "description": "Only with source \"user\": their words, without names. Up to 300 characters."
              },
              "lookingFor": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1,
                "description": "What the user was looking for, paraphrased, without names. Up to 300 characters."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string"
              },
              "received": {
                "type": "boolean"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Message the Mango Inventory team",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "create_account",
          "title": "Create an account",
          "description": "Create a Mango Inventory account in the user's name. Works without an account. Needs the user's name, email address and organization name; language, organization type and currency are optional. Mango Inventory sends ONE email to the address; its button confirms the address and signs the user in. The call returns no password, key or link. Once the address is confirmed, any account tool (for example get_setup_status) brings up the client's normal sign-in step (in Claude Code: /mcp), and after it every tool works. Until the button is pressed nothing can be done in the account, and an account that is never confirmed does nothing. The answer is the same whether or not the address already had an account; a refusal names its reason (invalid or disposable address, a domain that receives no mail, an invalid name, a rate limit). Idempotent: a repeat for the same address creates no second account. On a signed-in connection it answers signedIn and creates nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "email",
              "name",
              "orgName"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1,
                "description": "The user's name, as given. Up to 100 characters."
              },
              "email": {
                "type": "string",
                "maxLength": 254,
                "minLength": 3,
                "description": "The user's email address, as given."
              },
              "orgName": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1,
                "description": "The organization's name, as given. Up to 100 characters."
              },
              "orgType": {
                "enum": [
                  "school",
                  "company",
                  "publicAdmin",
                  "publicWorks",
                  "club",
                  "other"
                ],
                "type": "string",
                "description": "The kind of organization, if known (as in check_fit)."
              },
              "currency": {
                "enum": [
                  "chf",
                  "eur",
                  "gbp",
                  "usd"
                ],
                "type": "string",
                "description": "Their currency, if known: chf (default), eur, gbp or usd."
              },
              "language": {
                "enum": [
                  "en",
                  "de",
                  "fr",
                  "it",
                  "es"
                ],
                "type": "string",
                "description": "Their language for the email and the app: en (default), de, fr, it or es."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "next": {
                "type": "string",
                "description": "What happened and the next step"
              },
              "status": {
                "type": "string",
                "description": "accepted · refused · signedIn"
              },
              "refused": {
                "type": "string"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create an account",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "send_feedback",
          "title": "Tell the Mango Inventory team",
          "description": "Send a report about these tools to the Mango Inventory team, who read the stored reports to fix the tools: a tool that failed unexpectedly, an answer or error that made no sense, something the user needed that no tool offers, a workaround that was needed, or a message the user asked to pass on (source \"user\", their words in userWords). The report is stored and, within daily mail caps, emailed to the team as written, with Mango Inventory keys, tokens and bearer headers redacted and control characters stripped. Over 5 reports an hour or 20 a day per credential (40 a day per organization) a report is answered as received but not stored (`throttled: true`). A field over its stated length is cut (`shortened`); only a field over 4,000 characters is refused. Not idempotent: each call is a new report. Works on read-only connections; it changes none of the organization's data.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "summary",
              "kind",
              "impact",
              "goal"
            ],
            "properties": {
              "goal": {
                "type": "string",
                "maxLength": 4000,
                "description": "What the user wanted, paraphrased, without names. Up to 300 characters."
              },
              "kind": {
                "enum": [
                  "missing",
                  "broken",
                  "confusing",
                  "idea"
                ],
                "type": "string",
                "description": "missing = a capability the user needed does not exist; broken = a tool failed or gave a wrong result; confusing = a description, answer or error was misleading; idea = a suggestion."
              },
              "tool": {
                "type": "string",
                "maxLength": 4000,
                "description": "The tool involved, e.g. run_import. Up to 60 characters."
              },
              "model": {
                "type": "string",
                "maxLength": 4000,
                "description": "The AI model sending the report, if known. Up to 80 characters."
              },
              "impact": {
                "enum": [
                  "blocked",
                  "worked_around",
                  "friction",
                  "none"
                ],
                "type": "string",
                "description": "What it did to the task: blocked = it could not be done; worked_around = done another way; friction = done, but harder than it should be; none = no effect (an idea)."
              },
              "source": {
                "enum": [
                  "agent",
                  "user"
                ],
                "type": "string",
                "description": "agent (default) = the agent noticed it; user = the user asked for it to be passed on."
              },
              "summary": {
                "type": "string",
                "maxLength": 4000,
                "description": "One sentence: what did not work. Up to 200 characters."
              },
              "userWords": {
                "type": "string",
                "maxLength": 4000,
                "description": "Only with source \"user\": their words, without names. Up to 300 characters."
              },
              "suggestion": {
                "type": "string",
                "maxLength": 4000,
                "description": "What would have made it easy. Up to 500 characters."
              },
              "workaround": {
                "type": "string",
                "maxLength": 4000,
                "description": "What was done instead, if anything. Up to 500 characters."
              },
              "whatHappened": {
                "type": "string",
                "maxLength": 4000,
                "description": "The error text, what was expected and what came back. Up to 1000 characters."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "note": {
                "type": "string",
                "description": "A short acknowledgment"
              },
              "received": {
                "type": "boolean",
                "description": "True — the report was taken (also when it was not stored)"
              },
              "shortened": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Fields the server cut to their stated limit"
              },
              "throttled": {
                "type": "boolean",
                "description": "True when this credential or organization is over its report limit; this report was not stored, and reports over the limit are not stored"
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Tell the Mango Inventory team",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "setup-template-catalog",
          "uri": "mango-inventory://setup-templates",
          "mimeType": "application/json",
          "description": "Catalog of Mango Inventory's setup templates — opinionated inventory structures per kind of organization. Prefer the get_setup_template tool where available."
        },
        {
          "name": "setup-template-school_ch",
          "uri": "mango-inventory://setup-templates/school_ch",
          "mimeType": "application/json",
          "description": "Primary/secondary school inventory: IT devices with serial numbers, music and sports equipment, tools, furniture, teaching materials and consumables across school buildings and rooms."
        },
        {
          "name": "setup-template-office_facility",
          "uri": "mango-inventory://setup-templates/office_facility",
          "mimeType": "application/json",
          "description": "General company/office inventory: IT equipment with serial numbers, furniture, keys and access badges, shared appliances and office supplies across offices, meeting rooms and storage."
        },
        {
          "name": "setup-template-workshop_trade",
          "uri": "mango-inventory://setup-templates/workshop_trade",
          "mimeType": "application/json",
          "description": "Trade/craft business inventory: power tools with serial numbers and inspection dates, machines, vehicles, ladders, PPE and consumable stock across workshop, warehouse and vans."
        },
        {
          "name": "setup-template-sports_club",
          "uri": "mango-inventory://setup-templates/sports_club",
          "mimeType": "application/json",
          "description": "Club inventory: balls and training gear, jersey sets, tournament/event material, electronics and clubhouse keys — built around members borrowing equipment."
        },
        {
          "name": "item-card-widget",
          "uri": "ui://widget/item-card.html",
          "mimeType": "text/html;profile=mcp-app",
          "description": "HTML template rendering an inventory item as a card (Apps-SDK widget for get_item and create_item) or an editable create-confirm card (preview_item_create)."
        },
        {
          "name": "item-gallery-widget",
          "uri": "ui://widget/item-gallery.html",
          "mimeType": "text/html;profile=mcp-app",
          "description": "HTML template rendering a set of inventory items as a photo picker (Apps-SDK widget for show_items)."
        },
        {
          "name": "fit-card-widget",
          "uri": "ui://widget/fit-card.html",
          "mimeType": "text/html;profile=mcp-app",
          "description": "HTML template rendering a check_fit or quote answer as a card: verdict, covered and missing needs, plan and monthly price, and a Start link to sign up (Apps-SDK widget for check_fit and quote)."
        }
      ],
      "prompts": []
    },
    "instructions": "Mango Inventory is inventory management for organizations with a lot of inventory: equipment, tools, machines, IT devices, vehicles and the stock and consumables around them. Signed in, you act for the person who connected, in one organization: every call has their permissions, and every write is logged under their name, with \"(via AI agent)\".\n\nNot signed in yet? check_fit, quote, find_docs, tell_us and create_account work without an account; any other tool makes the client ask for sign-in.\n\nHow the data works:\n- Records are the organization's register, shown to its members as fact. Values are stored exactly as passed; optional fields may stay empty, and an item draft (isDraft) may lack required values.\n- A date field holds a calendar day. A month or a year alone is not a day: it fits a text field.\n- The server has no time zone and converts none. Date arguments take a plain day (\"2026-08-11\") or a timestamp with an offset; every returned date comes as epoch and ISO twin.\n- create_item, create_ticket and create_order take a clientRequestId: a repeated call with the same id returns the existing record instead of a duplicate. create_category, create_location, create_person, create_field_def and create_team take none: a repeated call creates a second record.\n- Database ids are handles for tool calls. Items carry a printed code (primaryCode); records carry webUrl, their page in the web app.\n\nSetting up an organization: get_setup_template serves starting structures per kind of organization, with the questions that shape a setup. scaffold_categories, scaffold_locations and scaffold_models return a dry run without confirm: true, so one call previews a whole tree and the same call with confirm: true commits it.\n\nImporting a list (a spreadsheet, a CSV, a pasted table): plan_import is a dry run of the product's importer that writes nothing and says per row what would be created, updated, skipped or dropped; run_import commits the same rows with the planHash plan_import returned, as one batch. Categories with typed fields (scaffold_categories) and item models for articles in sizes (scaffold_models) can be created before the import; plan_import lists the category and location names the import would create itself under toCreate, and archive_category archives unused starter categories. Vehicles, cases and carts are items with their own row, not locations; the rows of what sits inside name them in a container column. While an organization is within its free 50 items, an import may cross that allowance and comes in whole, but it is the last one: afterwards no published item can be added until the organization upgrades.\n\nFeedback: send_feedback reaches the Mango Inventory team, who read the stored reports to fix these tools: a tool that failed unexpectedly, an answer that made no sense, something missing, a workaround, or a message the user wants passed on.\n\nFinding things: inventory_overview answers \"what do we own, how many, what is broken\"; list_resources and search_resources find places and people; get_setup_status shows the configuration; search_items takes printed codes (\"BM-002\") and short name stems. An item's status is its condition; check_item_availability says whether it is free to hand out. get_item and show_items are the only tools with item photos. \"me\" means the connected user wherever a tool takes a person.\n\nApp only, no tool here: recording a maintenance check, editing maintenance plans."
  },
  "changes": {
    "total": 1,
    "latest": [
      {
        "observed_at": "2026-11-22T15:25:03.111Z",
        "from_sha": "119c24518a9ae4eff69d03ee3918ea8d6d287b18726455d0b79e9429b131d0df",
        "to_sha": "a9c8ffa5feaee244e4faf810ba83b3c9e60fea070948187a82dd37a9d820d927",
        "summary": {
          "tool_changed": 19
        },
        "diff": [
          {
            "op": "changed",
            "kind": "tool",
            "name": "assign_item",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "pack_item",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "unpack_item",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "transfer_stock",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_ticket",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "update_ticket",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "set_item_status",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "scaffold_categories",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "update_category",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "update_field_def",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "set_org_type",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "set_org_defaults",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_invite",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_invite",
            "path": "/annotations/openWorldHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "update_item",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "adjust_stock",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "set_min_stock",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "run_import",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_account",
            "path": "/annotations/destructiveHint",
            "after": true,
            "before": false
          }
        ],
        "withheld": false
      }
    ]
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}