Skip to main content
Glama
Sign In

Contracko

by com.contracko
OverviewDiscussionsAdmin

List contracts

clm_list_contracts
Read-onlyIdempotent

Find workspace contracts and filing. All filters must match. Reads stay available after trial lapse.

Input Schema

NameRequiredDescriptionDefault
limitNoPage size
queryNoLiteral case-insensitive substring in title or assigned party_b display/legal name.
cursorNoPrior page cursor; reuse with identical filters
statusNoStatus filter
folderIdNoFiled in this visible folder
endDateToNoNon-null endDate <= YYYY-MM-DD (inclusive).
categoryIdNoType ID filter
endDateFromNoNon-null endDate >= YYYY-MM-DD (inclusive).
noticeDateToNoComputed non-null notice date <= YYYY-MM-DD (inclusive).
updatedSinceNoUpdated >= ISO-8601 timestamp
counterpartyIdNoAssigned party_b ID
noticeDateFromNoComputed non-null notice date >= YYYY-MM-DD (inclusive).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed20 schema fields changed
    • changedInput schema / properties / categoryId / description
      Previous value: -"Return only contracts with this contract type."New value: +"Type ID filter"
    • removedInput schema / properties / categoryId / pattern
      Removed 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)$"
    • changedInput schema / properties / counterpartyId / description
      Previous value: -"Return only contracts assigned to this party as party_b."New value: +"Assigned party_b ID"
    • removedInput schema / properties / counterpartyId / pattern
      Removed 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)$"
    • changedInput schema / properties / cursor / description
      Previous value: -"Continuation reference from the previous page. Reuse it with the same filters."New value: +"Prior page cursor; reuse with identical filters"
    • changedInput schema / properties / endDateFrom / description
      Previous value: -"Return contracts with a non-null end date on or after this inclusive YYYY-MM-DD date."New value: +"Non-null endDate >= YYYY-MM-DD (inclusive)."
    • removedInput schema / properties / endDateFrom / pattern
      Removed value: -"^(?:(?:\\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])))$"
    • changedInput schema / properties / endDateTo / description
      Previous value: -"Return contracts with a non-null end date on or before this inclusive YYYY-MM-DD date."New value: +"Non-null endDate <= YYYY-MM-DD (inclusive)."
    • removedInput schema / properties / endDateTo / pattern
      Removed value: -"^(?:(?:\\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])))$"
    • changedInput schema / properties / folderId / description
      Previous value: -"Only return contracts filed in this visible folder."New value: +"Filed in this visible folder"
    • removedInput schema / properties / folderId / pattern
      Removed 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)$"
    • changedInput schema / properties / limit / description
      Previous value: -"Page size (max 100)."New value: +"Page size"
    • changedInput schema / properties / noticeDateFrom / description
      Previous value: -"Return contracts with a computed non-null notice date on or after this inclusive YYYY-MM-DD date."New value: +"Computed non-null notice date >= YYYY-MM-DD (inclusive)."
    • removedInput schema / properties / noticeDateFrom / pattern
      Removed value: -"^(?:(?:\\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])))$"
    • changedInput schema / properties / noticeDateTo / description
      Previous value: -"Return contracts with a computed non-null notice date on or before this inclusive YYYY-MM-DD date."New value: +"Computed non-null notice date <= YYYY-MM-DD (inclusive)."
    • removedInput schema / properties / noticeDateTo / pattern
      Removed value: -"^(?:(?:\\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])))$"
    • changedInput schema / properties / query / description
      Previous value: -"Literal case-insensitive substring in the contract title or assigned party_b display or legal name."New value: +"Literal case-insensitive substring in title or assigned party_b display/legal name."
    • changedInput schema / properties / status / description
      Previous value: -"Return only this contract status."New value: +"Status filter"
    • changedInput schema / properties / updatedSince / description
      Previous value: -"Return contracts updated at or after this ISO-8601 timestamp."New value: +"Updated >= ISO-8601 timestamp"
    • changedOutput schema / (root)
      Previous value: -{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "additionalProperties": false,
-  "definitions": {
-    "__schema0": {
-      "anyOf": [
-        {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "number"
-            },
-            {
-              "type": "boolean"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        {
-          "items": {
-            "allOf": [
-              {
-                "$ref": "#/definitions/__schema0"
-              }
-            ]
-          },
-          "type": "array"
-        },
-        {
-          "additionalProperties": {
-            "allOf": [
-              {
-                "$ref": "#/definitions/__schema0"
-              }
-            ]
-          },
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        }
-      ]
-    }
-  },
-  "properties": {
-    "items": {
-      "description": "Contracts in the current page",
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "accessInheritance": {
-            "enum": [
-              "inherit",
-              "override"
-            ],
-            "type": "string"
-          },
-          "agreementType": {
-            "anyOf": [
-              {
-                "enum": [
-                  "master_agreement",
-                  "statement_of_work",
-                  "order_form",
-                  "amendment",
-                  "schedule",
-                  "policy",
-                  "standalone_contract",
-                  "other"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "annualValue": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "autoRenewing": {
-            "type": "boolean"
-          },
-          "categoryId": {
-            "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"
-              }
-            ]
-          },
-          "childContracts": {
-            "anyOf": [
-              {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "agreementType": {
-                      "anyOf": [
-                        {
-                          "enum": [
-                            "master_agreement",
-                            "statement_of_work",
-                            "order_form",
-                            "amendment",
-                            "schedule",
-                            "policy",
-                            "standalone_contract",
-                            "other"
-                          ],
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "id": {
-                      "type": "string"
-                    },
-                    "title": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "id",
-                    "title"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "childCount": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "counterpartyNotes": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "counterpartyRelationshipType": {
-            "anyOf": [
-              {
-                "enum": [
-                  "vendor",
-                  "client",
-                  "partner",
-                  "other"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "createdAt": {
-            "format": "date-time",
-            "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"
-          },
-          "customFieldValues": {
-            "additionalProperties": {
-              "$ref": "#/definitions/__schema0"
-            },
-            "default": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "endDate": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "entityStatus": {
-            "anyOf": [
-              {
-                "anyOf": [
-                  {
-                    "enum": [
-                      "pending-review",
-                      "archived"
-                    ],
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "exclusivityDetails": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "filing": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "kind": {
-                    "const": "unfiled",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "folder": {
-                    "additionalProperties": false,
-                    "description": "Visible folder and ancestor path, leaf last",
-                    "properties": {
-                      "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"
-                          }
-                        ],
-                        "description": "Folder UUID",
-                        "type": "string"
-                      },
-                      "name": {
-                        "description": "Folder name",
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "parentFolderId": {
-                        "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"
-                          }
-                        ]
-                      },
-                      "path": {
-                        "description": "Visible ancestor path, leaf last",
-                        "items": {
-                          "additionalProperties": false,
-                          "properties": {
-                            "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"
-                                }
-                              ],
-                              "description": "Folder UUID",
-                              "type": "string"
-                            },
-                            "name": {
-                              "description": "Folder name",
-                              "minLength": 1,
-                              "type": "string"
-                            },
-                            "parentFolderId": {
-                              "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": [
-                            "id",
-                            "name",
-                            "parentFolderId"
-                          ],
-                          "type": "object"
-                        },
-                        "type": "array"
-                      }
-                    },
-                    "required": [
-                      "id",
-                      "name",
-                      "parentFolderId",
-                      "path"
-                    ],
-                    "type": "object"
-                  },
-                  "kind": {
-                    "const": "folder",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind",
-                  "folder"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "kind": {
-                    "const": "unavailable",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          "financialAnnualValue": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "financialTotalValue": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "financialValueCurrency": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "folderId": {
-            "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"
-              }
-            ]
-          },
-          "governingLaw": {
-            "anyOf": [
-              {
-                "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"
-          },
-          "isExclusive": {
-            "anyOf": [
-              {
-                "type": "boolean"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "isInNoticePeriod": {
-            "type": "boolean"
-          },
-          "isOpenEnded": {
-            "type": "boolean"
-          },
-          "jurisdiction": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "liabilityCapAmount": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "liabilityCapCurrency": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "liabilitySummary": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "noticeDate": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "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": "null"
-              }
-            ]
-          },
-          "noticeInstructions": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "parentContract": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "agreementType": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "master_agreement",
-                          "statement_of_work",
-                          "order_form",
-                          "amendment",
-                          "schedule",
-                          "policy",
-                          "standalone_contract",
-                          "other"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "id": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id",
-                  "title"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "parentContractId": {
-            "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"
-              }
-            ]
-          },
-          "parentContractTitle": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "parties": {
-            "default": [],
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "counterpartyId": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "isPrimary": {
-                  "description": "Party A and Party B are primary for their roles",
-                  "type": "boolean"
-                },
-                "legalName": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "name": {
-                  "description": "Application display name in the requested output language",
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "notes": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "role": {
-                  "enum": [
-                    "party_a",
-                    "party_b",
-                    "third_party"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "role",
-                "name"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "partiesSummary": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "processingStatus": {
-            "anyOf": [
-              {
-                "enum": [
-                  "processing",
-                  "completed",
-                  "failed"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "startDate": {
-            "type": "string"
-          },
-          "status": {
-            "enum": [
-              "active",
-              "notice-given",
-              "terminated",
-              "expired"
-            ],
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "updatedAt": {
-            "format": "date-time",
-            "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"
-          },
-          "visibility": {
-            "enum": [
-              "org",
-              "restricted"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "title",
-          "categoryId",
-          "status",
-          "financialAnnualValue",
-          "financialTotalValue",
-          "financialValueCurrency",
-          "startDate",
-          "endDate",
-          "autoRenewing",
-          "agreementType",
-          "parentContractId",
-          "visibility",
-          "accessInheritance",
-          "counterpartyRelationshipType",
-          "counterpartyNotes",
-          "isExclusive",
-          "liabilitySummary",
-          "liabilityCapAmount",
-          "liabilityCapCurrency",
-          "governingLaw",
-          "jurisdiction",
-          "noticeInstructions",
-          "partiesSummary",
-          "customFieldValues",
-          "entityStatus",
-          "processingStatus",
-          "folderId",
-          "createdAt",
-          "updatedAt",
-          "parties",
-          "isInNoticePeriod",
-          "noticeDate",
-          "isOpenEnded",
-          "filing"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "nextCursor": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    }
-  },
-  "required": [
-    "items",
-    "nextCursor"
-  ],
-  "type": "object"
-}New value: +null
  2. First observed

TDQS

C2.9/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds two non-annotation facts: filters combine conjunctively, and reads remain available after trial lapse — useful operational context — but says nothing about pagination behaviour or result ordering despite cursor/limit parameters.

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?

Three short sentences, front-loaded with the resource, and no filler. The phrase "and filing" is vague enough to be near-waste, but overall the definition is compact and readable.

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?

For a 12-parameter, zero-required list tool with no output schema, the description covers the resource and filter conjunction but not what a no-filter call returns, how paging interacts with cursor, or which fields the listed contracts expose. It is minimally sufficient to invoke correctly, not enough to invoke confidently.

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 coverage is 100%, so every one of the 12 parameters is already documented in the schema and the baseline 3 applies. The one piece of added meaning is "All filters must match" (conjunctive AND semantics across query, status, date ranges, folderId, counterpartyId), which the per-parameter descriptions do not state — a small genuine increment, but no guidance on defaults or no-filter behaviour.

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

Purpose3/5

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

"Find workspace contracts" names the resource, but the verb is loose (find vs. list vs. search) and the trailing "and filing" is ambiguous — it never clarifies whether folding/folder filing is a filter or a returned attribute. Nothing distinguishes it from clm_get_contract (single record) or clm_search_contract_documents (document text search) for an agent choosing among ~50 siblings.

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

Usage Guidelines2/5

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

There is no when-to-use or when-not-to-use guidance and no named alternative. "All filters must match" tells how filters combine, not when this tool rather than clm_get_contract or clm_search_contract_documents should be selected, leaving the routing decision entirely to the agent.

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

All Contracko toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources