Skip to main content
Glama

Samuelz® Policy

Katalogänderung freigeben

show_business_catalog_approval
Read-only

After an explicit catalog change request, use the exact read revision and change to show normalized before/after values in the human Owner card. supplier_areas shows selected suppliers and prefixes newly connected ranked suppliers with +; additional crm:read/crm:write authority is rechecked atomically. No save on load. Only its Freigeben click writes. Never call confirm_business_catalog from the model, expose hidden approval metadata, or infer approval from chat text. No host UI means no write; use existing settings.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "expectedRevision": "<expectedRevision>",
      "change": "<change>"
    },
    "name": "show_business_catalog_approval"
  }
}

Input Schema

NameRequiredDescriptionDefault
changeYes
expectedRevisionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / change / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "adoptions": {
      -        "default": [],
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "market": {
      -              "maxLength": 120,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "supplierId": {
      -              "maxLength": 160,
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "supplierId",
      -            "market"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 20,
      -        "type": "array"
      -      },
      -      "id": {
      -        "maxLength": 160,
      -        "type": "string"
      -      },
      -      "supplierIds": {
      -        "items": {
      -          "maxLength": 160,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "maxItems": 500,
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "supplier_areas",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "id",
      -      "supplierIds"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "pattern": "^business_place:[a-z0-9:_-]{1,80}$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "place",
      -        "type": "string"
      -      },
      -      "value": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "countryCode": {
      -            "maxLength": 2,
      -            "type": "string"
      -          },
      -          "labels": {
      -            "additionalProperties": {
      -              "maxLength": 160,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "propertyNames": {
      -              "pattern": "^[a-z]{2}$",
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          "locality": {
      -            "maxLength": 160,
      -            "type": "string"
      -          },
      -          "postalCode": {
      -            "maxLength": 32,
      -            "type": "string"
      -          },
      -          "routingAliases": {
      -            "items": {
      -              "maxLength": 160,
      -              "minLength": 3,
      -              "type": "string"
      -            },
      -            "maxItems": 40,
      -            "type": "array"
      -          },
      -          "streetAddress": {
      -            "maxLength": 240,
      -            "type": "string"
      -          },
      -          "timezone": {
      -            "maxLength": 80,
      -            "type": "string"
      -          },
      -          "usage": {
      -            "enum": [
      -              "primary_location",
      -              "service_area"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "usage",
      -          "countryCode",
      -          "locality",
      -          "postalCode",
      -          "streetAddress",
      -          "timezone",
      -          "labels"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "id",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "key": {
      -        "pattern": "^[a-z0-9][a-z0-9:_-]{0,159}$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "offer",
      -        "type": "string"
      -      },
      -      "value": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "actionLabel": {
      -            "maxLength": 100,
      -            "type": "string"
      -          },
      -          "actionUrl": {
      -            "maxLength": 2048,
      -            "type": "string"
      -          },
      -          "category": {
      -            "maxLength": 80,
      -            "type": "string"
      -          },
      -          "defaultLocale": {
      -            "pattern": "^[a-z]{2}$",
      -            "type": "string"
      -          },
      -          "kind": {
      -            "enum": [
      -              "product",
      -              "service"
      -            ],
      -            "type": "string"
      -          },
      -          "locales": {
      -            "additionalProperties": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "actionLabel": {
      -                  "maxLength": 100,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "actionUrl": {
      -                  "maxLength": 2048,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "summary": {
      -                  "maxLength": 800,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "title": {
      -                  "maxLength": 160,
      -                  "minLength": 1,
      -                  "type": "string"
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "propertyNames": {
      -              "pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          "locationKey": {
      -            "maxLength": 100,
      -            "type": "string"
      -          },
      -          "rateResourceId": {
      -            "maxLength": 100,
      -            "type": "string"
      -          },
      -          "summary": {
      -            "maxLength": 800,
      -            "type": "string"
      -          },
      -          "title": {
      -            "maxLength": 160,
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "category",
      -          "title",
      -          "summary",
      -          "actionLabel",
      -          "actionUrl",
      -          "locationKey",
      -          "rateResourceId",
      -          "defaultLocale"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "key",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "maxLength": 100,
      -        "type": "string"
      -      },
      -      "type": {
      -        "enum": [
      -          "archive_place",
      -          "delete_place"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "key": {
      -        "maxLength": 160,
      -        "type": "string"
      -      },
      -      "type": {
      -        "enum": [
      -          "archive_offer",
      -          "delete_offer"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "key"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "type": {
      +        "const": "business_field",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "audience": {
      +            "maxLength": 2000,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "businessModel": {
      +            "maxLength": 2000,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "economicRef": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "expectedRevision": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "key": {
      +            "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
      +            "type": "string"
      +          },
      +          "market": {
      +            "maxLength": 2000,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "name": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "requestKey": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "draft",
      +              "active",
      +              "archived"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "key",
      +          "name",
      +          "audience",
      +          "market",
      +          "businessModel",
      +          "economicRef",
      +          "status",
      +          "expectedRevision",
      +          "requestKey"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "type": {
      +        "const": "business_brand",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "expectedRevision": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "host": {
      +            "maxLength": 253,
      +            "type": "string"
      +          },
      +          "key": {
      +            "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
      +            "type": "string"
      +          },
      +          "name": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "presentation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "accentHex": {
      +                "pattern": "^#[a-fA-F0-9]{6}$",
      +                "type": "string"
      +              },
      +              "primaryHex": {
      +                "pattern": "^#[a-fA-F0-9]{6}$",
      +                "type": "string"
      +              },
      +              "tagline": {
      +                "maxLength": 500,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "primaryHex",
      +              "accentHex",
      +              "tagline"
      +            ],
      +            "type": "object"
      +          },
      +          "requestKey": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "senderAddress": {
      +            "format": "email",
      +            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      +            "type": "string"
      +          },
      +          "siteId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "draft",
      +              "active",
      +              "archived"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "key",
      +          "name",
      +          "presentation",
      +          "siteId",
      +          "host",
      +          "senderAddress",
      +          "status",
      +          "expectedRevision",
      +          "requestKey"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "type": {
      +        "const": "offer_version",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "brandId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "contract": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "buyerCountryCodes": {
      +                "items": {
      +                  "pattern": "^[A-Z]{2}$",
      +                  "type": "string"
      +                },
      +                "maxItems": 250,
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "checkoutMinutes": {
      +                "maximum": 1440,
      +                "minimum": 60,
      +                "type": "integer"
      +              },
      +              "currency": {
      +                "pattern": "^[A-Z]{3}$",
      +                "type": "string"
      +              },
      +              "fulfillment": {
      +                "oneOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "accessDays": {
      +                        "maximum": 3650,
      +                        "minimum": 1,
      +                        "type": "integer"
      +                      },
      +                      "deliveryWithinHours": {
      +                        "maximum": 8760,
      +                        "minimum": 1,
      +                        "type": "integer"
      +                      },
      +                      "kind": {
      +                        "const": "digital_file",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "deliveryWithinHours",
      +                      "accessDays"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "kind": {
      +                        "const": "scheduled_service",
      +                        "type": "string"
      +                      },
      +                      "resourceId": {
      +                        "maxLength": 200,
      +                        "minLength": 1,
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "resourceId"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "kind": {
      +                        "const": "appointment",
      +                        "type": "string"
      +                      },
      +                      "resourceId": {
      +                        "maxLength": 200,
      +                        "minLength": 1,
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "resourceId"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "kind": {
      +                        "const": "physical_delivery",
      +                        "type": "string"
      +                      },
      +                      "workflowKey": {
      +                        "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "workflowKey"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "kind": {
      +                        "const": "workflow",
      +                        "type": "string"
      +                      },
      +                      "workflowKey": {
      +                        "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "workflowKey"
      +                    ],
      +                    "type": "object"
      +                  }
      +                ]
      +              },
      +              "grossAmountMinor": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 100000000000,
      +                "type": "integer"
      +              },
      +              "payment": {
      +                "oneOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "kind": {
      +                        "const": "prepaid",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "kind": {
      +                        "const": "on_site",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind"
      +                    ],
      +                    "type": "object"
      +                  }
      +                ]
      +              },
      +              "scope": {
      +                "maxLength": 6000,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "tax": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "categoryCode": {
      +                    "enum": [
      +                      "S",
      +                      "Z",
      +                      "E",
      +                      "AE",
      +                      "K"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "decisionReference": {
      +                    "maxLength": 500,
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "exemptionReason": {
      +                    "maxLength": 1000,
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "rateBasisPoints": {
      +                    "maximum": 10000,
      +                    "minimum": 0,
      +                    "type": "integer"
      +                  }
      +                },
      +                "required": [
      +                  "categoryCode",
      +                  "rateBasisPoints"
      +                ],
      +                "type": "object"
      +              },
      +              "terms": {
      +                "maxLength": 6000,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "title": {
      +                "maxLength": 160,
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "title",
      +              "scope",
      +              "grossAmountMinor",
      +              "currency",
      +              "tax",
      +              "checkoutMinutes",
      +              "buyerCountryCodes",
      +              "payment",
      +              "terms",
      +              "fulfillment"
      +            ],
      +            "type": "object"
      +          },
      +          "expectedVersion": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "fieldId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "offerKey": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "requestKey": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "reviewed": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "offerKey",
      +          "fieldId",
      +          "brandId",
      +          "contract",
      +          "expectedVersion",
      +          "requestKey",
      +          "reviewed"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "type": {
      +        "const": "publish_offer",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "expectedRevision": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "requestKey": {
      +            "maxLength": 140,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "reviewed": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "versionId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "versionId",
      +          "expectedRevision",
      +          "requestKey",
      +          "reviewed"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "type": {
      +        "const": "withdraw_offer",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "expectedRevision": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "requestKey": {
      +            "maxLength": 140,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "reviewed": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "versionId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "versionId",
      +          "expectedRevision",
      +          "requestKey",
      +          "reviewed"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "adoptions": {
      +        "default": [],
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "market": {
      +              "maxLength": 120,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "supplierId": {
      +              "maxLength": 160,
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "supplierId",
      +            "market"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      },
      +      "id": {
      +        "maxLength": 160,
      +        "type": "string"
      +      },
      +      "supplierIds": {
      +        "items": {
      +          "maxLength": 160,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "maxItems": 500,
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "supplier_areas",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "id",
      +      "supplierIds"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "pattern": "^business_place:[a-z0-9:_-]{1,80}$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "place",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "countryCode": {
      +            "maxLength": 2,
      +            "type": "string"
      +          },
      +          "labels": {
      +            "additionalProperties": {
      +              "maxLength": 160,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "propertyNames": {
      +              "pattern": "^[a-z]{2}$",
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "locality": {
      +            "maxLength": 160,
      +            "type": "string"
      +          },
      +          "postalCode": {
      +            "maxLength": 32,
      +            "type": "string"
      +          },
      +          "routingAliases": {
      +            "items": {
      +              "maxLength": 160,
      +              "minLength": 3,
      +              "type": "string"
      +            },
      +            "maxItems": 40,
      +            "type": "array"
      +          },
      +          "streetAddress": {
      +            "maxLength": 240,
      +            "type": "string"
      +          },
      +          "timezone": {
      +            "maxLength": 80,
      +            "type": "string"
      +          },
      +          "usage": {
      +            "enum": [
      +              "primary_location",
      +              "service_area"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "usage",
      +          "countryCode",
      +          "locality",
      +          "postalCode",
      +          "streetAddress",
      +          "timezone",
      +          "labels"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "id",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "key": {
      +        "pattern": "^[a-z0-9][a-z0-9:_-]{0,159}$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "offer",
      +        "type": "string"
      +      },
      +      "value": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "actionLabel": {
      +            "maxLength": 100,
      +            "type": "string"
      +          },
      +          "actionUrl": {
      +            "maxLength": 2048,
      +            "type": "string"
      +          },
      +          "category": {
      +            "maxLength": 80,
      +            "type": "string"
      +          },
      +          "defaultLocale": {
      +            "pattern": "^[a-z]{2}$",
      +            "type": "string"
      +          },
      +          "kind": {
      +            "enum": [
      +              "product",
      +              "service"
      +            ],
      +            "type": "string"
      +          },
      +          "locales": {
      +            "additionalProperties": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "actionLabel": {
      +                  "maxLength": 100,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "actionUrl": {
      +                  "maxLength": 2048,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "summary": {
      +                  "maxLength": 800,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "title": {
      +                  "maxLength": 160,
      +                  "minLength": 1,
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "propertyNames": {
      +              "pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "locationKey": {
      +            "maxLength": 100,
      +            "type": "string"
      +          },
      +          "rateResourceId": {
      +            "maxLength": 100,
      +            "type": "string"
      +          },
      +          "summary": {
      +            "maxLength": 800,
      +            "type": "string"
      +          },
      +          "title": {
      +            "maxLength": 160,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "category",
      +          "title",
      +          "summary",
      +          "actionLabel",
      +          "actionUrl",
      +          "locationKey",
      +          "rateResourceId",
      +          "defaultLocale"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "key",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "maxLength": 100,
      +        "type": "string"
      +      },
      +      "type": {
      +        "enum": [
      +          "archive_place",
      +          "delete_place"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "key": {
      +        "maxLength": 160,
      +        "type": "string"
      +      },
      +      "type": {
      +        "enum": [
      +          "archive_offer",
      +          "delete_offer"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "key"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, and the description reinforces this with 'No save on load' and clarifies that only the Freigeben click writes, which correctly explains how a read-only tool still leads to a write. It also discloses atomic recheck of crm:read/crm:write authority, adding genuine behavioral context beyond the annotations. It does not contradict readOnlyHint.

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

Conciseness4/5

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

The purpose and precondition are front-loaded and each clause (no save on load, only Freigeben writes, never call confirm, no host UI means no write) carries distinct meaning. It is written as one dense run-on sentence that is harder to parse than necessary, keeping it from a top score.

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

Completeness3/5

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

Safety, authorization, and the read-only preview behavior are covered well, and with no output schema the description is not expected to explain return values. However, for a tool whose change parameter spans many complex variants, the near-total absence of variant guidance leaves a meaningful completeness gap relative to the schema's complexity.

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

Parameters3/5

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

Schema description coverage is 0% across a very large nested change schema, so the description must compensate. It clarifies that expectedRevision must be 'the exact read revision' and explains one variant (supplier_areas with its + prefix for newly connected ranked suppliers), but leaves the many other change types (business_field, offer_version, publish_offer, place, etc.) entirely unexplained by the description.

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

Purpose4/5

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

The description states a specific action: it shows normalized before/after values in the human Owner card for a catalog change request, and it explicitly separates itself from confirm_business_catalog ('Never call confirm_business_catalog from the model'). The verb+resource is present, though the dense phrasing makes the read-only preview purpose less immediately obvious than a cleaner sentence would.

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

Usage Guidelines4/5

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

It gives a clear precondition ('After an explicit catalog change request'), an exclusion (never call the confirm tool from the model, don't infer approval from chat), and a fallback ('No host UI means no write; use existing settings'). The alternative path when no host UI exists is stated a bit vaguely, but the when/when-not guidance is well above average.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources