clm_update_event_remindersChange linked notification timing/recipient/message; email recipients when due. Item failures keep their reason in results; resend only the failed items with a new idempotencyKey and reuse the original key only for an identical full replay.
| Name | Required | Description | Default |
|---|---|---|---|
| reminders | Yes | Notification changes | |
| idempotencyKey | Yes | Identical-input retry key |
Changes observed during successful MCP inspections.
Input schema / properties / idempotencyKey / descriptionAdded value: +"Identical-input retry key"Input schema / properties / reminders / descriptionAdded value: +"Notification changes"Input schema / properties / reminders / items / properties / contractId / patternRemoved value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"Input schema / properties / reminders / items / properties / message / anyOfRemoved value: -[
- {
- "maxLength": 5000,
- "type": "string"
- },
- {
- "type": "null"
- }
-]Input schema / properties / reminders / items / properties / message / maxLengthAdded value: +5000Input schema / properties / reminders / items / properties / message / typeAdded value: +[
+ "string",
+ "null"
+]Input schema / properties / reminders / items / properties / recipient / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "type": {
- "const": "contract_owner",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "type": {
- "const": "user",
- "type": "string"
- },
- "userId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- },
- "required": [
- "type",
- "userId"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "type": {
+ "const": "contract_owner",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "type": {
+ "const": "user",
+ "type": "string"
+ },
+ "userId": {
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "userId"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / reminders / items / properties / reminderId / patternRemoved value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"Output schema / (root)Previous value: -{
- "$schema": "http://json-schema.org/draft-07/schema#",
- "additionalProperties": false,
- "properties": {
- "results": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "contractId": {
- "allOf": [
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- ],
- "type": "string"
- },
- "error": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "errorCode": {
- "anyOf": [
- {
- "enum": [
- "conflict",
- "denied",
- "invalid",
- "not_found",
- "failed"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "ok": {
- "type": "boolean"
- },
- "reminder": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "anchorType": {
- "enum": [
- "custom",
- "system"
- ],
- "type": "string"
- },
- "contractId": {
- "allOf": [
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- ],
- "type": "string"
- },
- "eventId": {
- "anyOf": [
- {
- "allOf": [
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "id": {
- "allOf": [
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- ],
- "type": "string"
- },
- "isDisabled": {
- "type": "boolean"
- },
- "message": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "offsetDirection": {
- "enum": [
- "before",
- "on",
- "after"
- ],
- "type": "string"
- },
- "offsetUnit": {
- "enum": [
- "days",
- "weeks",
- "months",
- "quarters",
- "years"
- ],
- "type": "string"
- },
- "offsetValue": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "recipient": {
- "oneOf": [
- {
- "additionalProperties": false,
- "properties": {
- "type": {
- "const": "contract_owner",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "type": {
- "const": "user",
- "type": "string"
- },
- "userId": {
- "allOf": [
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "userId"
- ],
- "type": "object"
- }
- ]
- },
- "systemType": {
- "anyOf": [
- {
- "enum": [
- "notice",
- "end",
- "renewal",
- "open_ended_review"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "updatedAt": {
- "allOf": [
- {
- "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
- "type": "string"
- },
- {
- "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
- "type": "string"
- }
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "contractId",
- "anchorType",
- "eventId",
- "systemType",
- "offsetValue",
- "offsetUnit",
- "offsetDirection",
- "recipient",
- "message",
- "isDisabled",
- "updatedAt"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "reminderId": {
- "anyOf": [
- {
- "allOf": [
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- {
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- }
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- }
- },
- "required": [
- "contractId",
- "reminderId",
- "ok",
- "reminder",
- "error",
- "errorCode"
- ],
- "type": "object"
- },
- "type": "array"
- }
- },
- "required": [
- "results"
- ],
- "type": "object"
-}New value: +nullDoes the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructiveHint=true and idempotentHint=true, so the safety profile is covered; the description adds value beyond them by disclosing per-item partial failure semantics (failures retain their reason in results) and the exact idempotency key policy for full versus partial replays. It does not explain what state is overwritten by an update or whether unchanged fields are preserved, which matters for a destructive operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two dense sentences with no filler, and the core purpose is front-loaded ahead of the failure-handling detail. The phrasing is telegraphic to the point of ambiguity in places ('linked notification' is unexplained), which keeps it just short of ideal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a batch mutation over a nested reminder array with up to 100 items and no output schema, the description covers failure reporting and key reuse but omits atomicity (are successful items committed when others fail?), the concurrency role of expectedUpdatedAt, and any permission requirements. It is adequate to attempt a call but leaves real gaps for a destructive batch write.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both parameters are already documented and the baseline applies. The description does enrich idempotencyKey semantics beyond the schema's terse 'Identical-input retry key' by explaining when to mint a new key versus reuse the original, but it says nothing about the nested reminder fields (offset direction/unit, recipient variants, expectedUpdatedAt concurrency check).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb ('Change') and the exact mutable facets (timing/recipient/message) of event-linked notifications, plus the downstream effect ('email recipients when due'). The resource is clearly distinct from clm_create_event_reminders and clm_delete_event_reminders, but no sibling is named, so the separation is inferred rather than stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives concrete operational guidance for the retry scenario: resend only failed items with a new idempotencyKey, and reuse the original key only for an identical full replay. That is genuinely useful when-to-use guidance for one case, but there is no guidance on when to prefer this tool over clm_update_contract_events or the create/delete reminder siblings, nor any precondition such as required permissions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.