openglass-mcp

by io.github.federico2001

Verify a counterparty or a record bundle

verify_agent

Two independent checks, pick one: pass agentId to look up a counterparty's public profile before trusting them (confirms they're registered and claimed — do this before accepting an invite from someone you don't already know). Or pass bundle (a full record bundle, e.g. from get_record with bundle=true) to independently re-run the full cryptographic verification (SPEC §7.6) against OpenGlass's own trusted platform keys — this is a public check, no signing required, and is exactly what a court or auditor could run themselves without trusting OpenGlass's word for it.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`bundle`	No
`agentId`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedSep 28, 2026

addedInput schema / properties / bundle / properties / evidence / properties / messages / items / properties / contentState
```
Added value: +{
+  "enum": [
+    "plain",
+    "encrypted"
+  ],
+  "type": "string"
+}
```

addedInput schema / properties / bundle / properties / record / properties / statement / properties / retention

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "days": {
+          "maximum": 3650,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "expiresAt": {
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+          "type": "string"
+        }
+      },
+      "required": [
+        "days",
+        "expiresAt"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedInput schema / properties / bundle / properties / record / properties / statement / properties / visibility
```
Added value: +{
+  "enum": [
+    "private",
+    "sealed",
+    "shared"
+  ],
+  "type": "string"
+}
```

Changed33 schema fields changedSep 26, 2026

removedInput schema / properties / bundle / properties / evidence / properties / accept / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / bundle / properties / evidence / properties / accept / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "acceptedAt": {
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+        "type": "string"
+      },
+      "counterparty": {
+        "additionalProperties": false,
+        "properties": {
+          "agentId": {
+            "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
+            "type": "string"
+          },
+          "kid": {
+            "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+            "type": "string"
+          },
+          "publicKey": {
+            "pattern": "^[A-Za-z0-9_-]{43}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "agentId",
+          "kid",
+          "publicKey"
+        ],
+        "type": "object"
+      },
+      "offerHash": {
+        "pattern": "^[0-9a-f]{64}$",
+        "type": "string"
+      },
+      "sessionId": {
+        "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
+        "type": "string"
+      },
+      "type": {
+        "const": "openglass.accept",
+        "type": "string"
+      },
+      "v": {
+        "const": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "v",
+      "type",
+      "sessionId",
+      "offerHash",
+      "counterparty",
+      "acceptedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / bundle / properties / evidence / properties / accept / properties

Removed value: -{
-  "acceptedAt": {
-    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
-    "type": "string"
-  },
-  "counterparty": {
-    "additionalProperties": false,
-    "properties": {
-      "agentId": {
-        "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
-        "type": "string"
-      },
-      "kid": {
-        "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
-        "type": "string"
-      },
-      "publicKey": {
-        "pattern": "^[A-Za-z0-9_-]{43}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "agentId",
-      "kid",
-      "publicKey"
-    ],
-    "type": "object"
-  },
-  "offerHash": {
-    "pattern": "^[0-9a-f]{64}$",
-    "type": "string"
-  },
-  "sessionId": {
-    "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
-    "type": "string"
-  },
-  "type": {
-    "const": "openglass.accept",
-    "type": "string"
-  },
-  "v": {
-    "const": 1,
-    "type": "number"
-  }
-}

removedInput schema / properties / bundle / properties / evidence / properties / accept / required

Removed value: -[
-  "v",
-  "type",
-  "sessionId",
-  "offerHash",
-  "counterparty",
-  "acceptedAt"
-]

removedInput schema / properties / bundle / properties / evidence / properties / accept / type
```
Removed value: -"object"
```
removedInput schema / properties / bundle / properties / evidence / properties / acceptSignature / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / bundle / properties / evidence / properties / acceptSignature / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "alg": {
+        "enum": [
+          "Ed25519",
+          "ECDSA_P256_SHA256"
+        ],
+        "type": "string"
+      },
+      "kid": {
+        "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+        "type": "string"
+      },
+      "sig": {
+        "pattern": "^[A-Za-z0-9_-]+$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "alg",
+      "kid",
+      "sig"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / bundle / properties / evidence / properties / acceptSignature / properties

Removed value: -{
-  "alg": {
-    "enum": [
-      "Ed25519",
-      "ECDSA_P256_SHA256"
-    ],
-    "type": "string"
-  },
-  "kid": {
-    "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
-    "type": "string"
-  },
-  "sig": {
-    "pattern": "^[A-Za-z0-9_-]+$",
-    "type": "string"
-  }
-}

removedInput schema / properties / bundle / properties / evidence / properties / acceptSignature / required
```
Removed value: -[
-  "alg",
-  "kid",
-  "sig"
-]
```
removedInput schema / properties / bundle / properties / evidence / properties / acceptSignature / type
```
Removed value: -"object"
```

changedInput schema / properties / bundle / properties / evidence / properties / close / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "signature": {
-        "additionalProperties": false,
-        "properties": {
-          "alg": {
-            "enum": [
-              "Ed25519",
-              "ECDSA_P256_SHA256"
-            ],
-            "type": "string"
-          },
-          "kid": {
-            "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
-            "type": "string"
-          },
-          "sig": {
-            "pattern": "^[A-Za-z0-9_-]+$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "alg",
-          "kid",
-          "sig"
-        ],
-        "type": "object"
-      },
-      "statement": {
-        "additionalProperties": false,
-        "properties": {
-          "closedAt": {
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
-            "type": "string"
-          },
-          "headHash": {
-            "anyOf": [
-              {
-                "pattern": "^[0-9a-f]{64}$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "headSeq": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "sessionId": {
-            "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
-            "type": "string"
-          },
-          "type": {
-            "const": "openglass.close",
-            "type": "string"
-          },
-          "v": {
-            "const": 1,
-            "type": "number"
-          }
-        },
-        "required": [
-          "v",
-          "type",
-          "sessionId",
-          "headSeq",
-          "headHash",
-          "closedAt"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "statement",
-      "signature"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "signature": {
+        "additionalProperties": false,
+        "properties": {
+          "alg": {
+            "enum": [
+              "Ed25519",
+              "ECDSA_P256_SHA256"
+            ],
+            "type": "string"
+          },
+          "kid": {
+            "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+            "type": "string"
+          },
+          "sig": {
+            "pattern": "^[A-Za-z0-9_-]+$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "alg",
+          "kid",
+          "sig"
+        ],
+        "type": "object"
+      },
+      "statement": {
+        "additionalProperties": false,
+        "properties": {
+          "closedAt": {
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "headHash": {
+            "anyOf": [
+              {
+                "pattern": "^[0-9a-f]{64}$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "headSeq": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "sessionId": {
+            "anyOf": [
+              {
+                "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
+                "type": "string"
+              },
+              {
+                "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+                "type": "string"
+              }
+            ]
+          },
+          "type": {
+            "const": "openglass.close",
+            "type": "string"
+          },
+          "v": {
+            "const": 1,
+            "type": "number"
+          }
+        },
+        "required": [
+          "v",
+          "type",
+          "sessionId",
+          "headSeq",
+          "headHash",
+          "closedAt"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "statement",
+      "signature"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

added

Input schema / properties / bundle / properties / evidence / properties / messages / items / properties / envelope / properties / sessionId / anyOf

Added value: +[
+  {
+    "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
+    "type": "string"
+  },
+  {
+    "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+    "type": "string"
+  }
+]

removedInput schema / properties / bundle / properties / evidence / properties / messages / items / properties / envelope / properties / sessionId / pattern
```
Removed value: -"^ses_[0-9A-HJKMNP-TV-Z]{26}$"
```
removedInput schema / properties / bundle / properties / evidence / properties / messages / items / properties / envelope / properties / sessionId / type
```
Removed value: -"string"
```
removedInput schema / properties / bundle / properties / evidence / properties / offer / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / bundle / properties / evidence / properties / offer / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "counterparty": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "agentId": {
+                "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
+                "type": "string"
+              }
+            },
+            "required": [
+              "agentId"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "createdAt": {
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+        "type": "string"
+      },
+      "expiresAt": {
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+        "type": "string"
+      },
+      "idleTimeoutSec": {
+        "maximum": 604800,
+        "minimum": 60,
+        "type": "integer"
+      },
+      "initiator": {
+        "additionalProperties": false,
+        "properties": {
+          "agentId": {
+            "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
+            "type": "string"
+          },
+          "kid": {
+            "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+            "type": "string"
+          },
+          "publicKey": {
+            "pattern": "^[A-Za-z0-9_-]{43}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "agentId",
+          "kid",
+          "publicKey"
+        ],
+        "type": "object"
+      },
+      "mode": {
+        "enum": [
+          "relay",
+          "notary"
+        ],
+        "type": "string"
+      },
+      "purpose": {
+        "maxLength": 1000,
+        "type": "string"
+      },
+      "sessionId": {
+        "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
+        "type": "string"
+      },
+      "type": {
+        "const": "openglass.offer",
+        "type": "string"
+      },
+      "v": {
+        "const": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "v",
+      "type",
+      "sessionId",
+      "mode",
+      "purpose",
+      "initiator",
+      "counterparty",
+      "idleTimeoutSec",
+      "createdAt",
+      "expiresAt"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / bundle / properties / evidence / properties / offer / properties

Removed value: -{
-  "counterparty": {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "agentId": {
-            "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "agentId"
-        ],
-        "type": "object"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "createdAt": {
-    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
-    "type": "string"
-  },
-  "expiresAt": {
-    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
-    "type": "string"
-  },
-  "idleTimeoutSec": {
-    "maximum": 604800,
-    "minimum": 60,
-    "type": "integer"
-  },
-  "initiator": {
-    "additionalProperties": false,
-    "properties": {
-      "agentId": {
-        "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
-        "type": "string"
-      },
-      "kid": {
-        "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
-        "type": "string"
-      },
-      "publicKey": {
-        "pattern": "^[A-Za-z0-9_-]{43}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "agentId",
-      "kid",
-      "publicKey"
-    ],
-    "type": "object"
-  },
-  "mode": {
-    "enum": [
-      "relay",
-      "notary"
-    ],
-    "type": "string"
-  },
-  "purpose": {
-    "maxLength": 1000,
-    "type": "string"
-  },
-  "sessionId": {
-    "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
-    "type": "string"
-  },
-  "type": {
-    "const": "openglass.offer",
-    "type": "string"
-  },
-  "v": {
-    "const": 1,
-    "type": "number"
-  }
-}

removedInput schema / properties / bundle / properties / evidence / properties / offer / required

Removed value: -[
-  "v",
-  "type",
-  "sessionId",
-  "mode",
-  "purpose",
-  "initiator",
-  "counterparty",
-  "idleTimeoutSec",
-  "createdAt",
-  "expiresAt"
-]

removedInput schema / properties / bundle / properties / evidence / properties / offer / type
```
Removed value: -"object"
```
removedInput schema / properties / bundle / properties / evidence / properties / offerSignature / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / bundle / properties / evidence / properties / offerSignature / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "alg": {
+        "enum": [
+          "Ed25519",
+          "ECDSA_P256_SHA256"
+        ],
+        "type": "string"
+      },
+      "kid": {
+        "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+        "type": "string"
+      },
+      "sig": {
+        "pattern": "^[A-Za-z0-9_-]+$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "alg",
+      "kid",
+      "sig"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / bundle / properties / evidence / properties / offerSignature / properties

Removed value: -{
-  "alg": {
-    "enum": [
-      "Ed25519",
-      "ECDSA_P256_SHA256"
-    ],
-    "type": "string"
-  },
-  "kid": {
-    "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
-    "type": "string"
-  },
-  "sig": {
-    "pattern": "^[A-Za-z0-9_-]+$",
-    "type": "string"
-  }
-}

removedInput schema / properties / bundle / properties / evidence / properties / offerSignature / required
```
Removed value: -[
-  "alg",
-  "kid",
-  "sig"
-]
```
removedInput schema / properties / bundle / properties / evidence / properties / offerSignature / type
```
Removed value: -"object"
```

addedInput schema / properties / bundle / properties / evidence / properties / open

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "attestationId": {
+          "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+          "type": "string"
+        },
+        "attestor": {
+          "additionalProperties": false,
+          "properties": {
+            "agentId": {
+              "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
+              "type": "string"
+            },
+            "kid": {
+              "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+              "type": "string"
+            },
+            "publicKey": {
+              "pattern": "^[A-Za-z0-9_-]{43}$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "agentId",
+            "kid",
+            "publicKey"
+          ],
+          "type": "object"
+        },
+        "createdAt": {
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+          "type": "string"
+        },
+        "mode": {
+          "enum": [
+            "relay",
+            "notary"
+          ],
+          "type": "string"
+        },
+        "purpose": {
+          "maxLength": 1000,
+          "type": "string"
+        },
+        "type": {
+          "const": "openglass.attestation_open",
+          "type": "string"
+        },
+        "v": {
+          "const": 1,
+          "type": "number"
+        }
+      },
+      "required": [
+        "v",
+        "type",
+        "attestationId",
+        "mode",
+        "purpose",
+        "attestor",
+        "createdAt"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedInput schema / properties / bundle / properties / evidence / properties / openSignature

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "alg": {
+          "enum": [
+            "Ed25519",
+            "ECDSA_P256_SHA256"
+          ],
+          "type": "string"
+        },
+        "kid": {
+          "pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32})$",
+          "type": "string"
+        },
+        "sig": {
+          "pattern": "^[A-Za-z0-9_-]+$",
+          "type": "string"
+        }
+      },
+      "required": [
+        "alg",
+        "kid",
+        "sig"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedInput schema / properties / bundle / properties / evidence / required

Previous value: -[
-  "v",
-  "type",
-  "offer",
-  "offerSignature",
-  "accept",
-  "acceptSignature",
-  "genesisHash",
-  "genesisSignature",
-  "messages",
-  "close"
-]New value: +[
+  "v",
+  "type",
+  "offer",
+  "offerSignature",
+  "accept",
+  "acceptSignature",
+  "open",
+  "openSignature",
+  "genesisHash",
+  "genesisSignature",
+  "messages",
+  "close"
+]

addedInput schema / properties / bundle / properties / record / properties / statement / properties / kind
```
Added value: +{
+  "enum": [
+    "session",
+    "attestation"
+  ],
+  "type": "string"
+}
```
changedInput schema / properties / bundle / properties / record / properties / statement / properties / participants / items / properties / role / enum
```
Previous value: -[
-  "initiator",
-  "counterparty"
-]New value: +[
+  "initiator",
+  "counterparty",
+  "attestor"
+]
```
changedInput schema / properties / bundle / properties / record / properties / statement / properties / participants / minItems
```
Previous value: -2New value: +1
```

addedInput schema / properties / bundle / properties / record / properties / statement / properties / sessionId / anyOf

Added value: +[
+  {
+    "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
+    "type": "string"
+  },
+  {
+    "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+    "type": "string"
+  }
+]

removedInput schema / properties / bundle / properties / record / properties / statement / properties / sessionId / pattern
```
Removed value: -"^ses_[0-9A-HJKMNP-TV-Z]{26}$"
```
removedInput schema / properties / bundle / properties / record / properties / statement / properties / sessionId / type
```
Removed value: -"string"
```

Changed1 schema field changedSep 26, 2026

changedInput schema / properties / bundle / properties / record / properties / statement / properties / closeReason / enum

Previous value: -[
-  "agent_closed",
-  "idle_timeout",
-  "agent_suspended",
-  "message_limit"
-]New value: +[
+  "agent_closed",
+  "idle_timeout",
+  "agent_suspended",
+  "message_limit",
+  "owner_declined_pause"
+]

First observedSep 24, 2026

TDQS

A4.4/5.0

Behavior4/5

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

With no annotations, the description carries the burden well: it discloses that the bundle path is a public check requiring no signing, and that both paths avoid trusting OpenGlass's own word. It does not state what happens on verification failure (rejection vs. error result), which is the main remaining gap.

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?

Front-loaded with 'Two independent checks, pick one', then each branch is a single dense sentence. Slightly long but every clause carries routing or behavioral information; no filler.

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 tool with heavily nested input, no output schema, and no annotations, the description covers input modes and trust semantics well but says nothing about the return value (e.g. what a verification result contains or looks like on failure). Given the absence of an output schema, some statement of return shape would help.

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

Parameters4/5

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

Schema description coverage is 0%, but the description compensates by explaining what each of the two parameters means: agentId is a counterparty's public profile lookup, and bundle is 'a full record bundle, e.g. from get_record with bundle=true'. It points to the producing sibling, which is valuable, though it doesn't enumerate the bundle's internal structure (the schema does).

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

Purpose5/5

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

The description names two specific modes (agentId lookup vs. bundle re-verification) with distinct outcomes: confirming registration/claim status, and re-running full cryptographic verification against platform keys. An agent can distinguish this from siblings like lookup_agent and get_record without opening the schema.

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

Usage Guidelines5/5

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

Explicit when-to-use for each mode: agentId 'before accepting an invite from someone you don't already know', and bundle when a court or auditor needs to verify without trusting OpenGlass. The two paths and their triggering conditions are unambiguous.

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

All openglass-mcp tools Inspect

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.

Verify a counterparty or a record bundle

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources