Skip to main content
Glama

MemoStem

by io.github.girapphe
OverviewDiscussionsAdmin

Create structured knowledge-bundle drafts

create_knowledge_bundle_drafts
Idempotent

Create pending, user-owned concept, general procedure, comparison, mechanism, structure, claim/evidence, knowledge question, historical event, or language-expression drafts only after clear affirmative consent to specifically named, independently teachable general knowledge in the current conversation. Every bundle must declare knowledge_scope as general_knowledge; decisions and organization-specific material are not accepted. An assistant suggestion alone is not consent. It cannot approve drafts, retain transcripts, or modify public knowledge.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bundlesYes
providerYes
provenanceYes
request_idYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
statusYes
createdYes
batch_idYes
review_urlYes
review_pathYes
bundle_countYes
review_flagsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / review_flags
      Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "client_id": {
+        "maxLength": 160,
+        "minLength": 1,
+        "type": "string"
+      },
+      "code": {
+        "enum": [
+          "possible_autobiographical",
+          "possible_organization_specific",
+          "possible_choice_rationale",
+          "possible_task_or_meeting",
+          "possible_project_status"
+        ],
+        "type": "string"
+      },
+      "field": {
+        "maxLength": 240,
+        "type": "string"
+      },
+      "match": {
+        "maxLength": 80,
+        "type": "string"
+      },
+      "message": {
+        "maxLength": 240,
+        "type": "string"
+      }
+    },
+    "required": [
+      "client_id",
+      "code",
+      "field",
+      "match",
+      "message"
+    ],
+    "type": "object"
+  },
+  "maxItems": 600,
+  "type": "array"
+}
    • changedOutput schema / required
      Previous value: -[
-  "status",
-  "batch_id",
-  "created",
-  "bundle_count",
-  "review_path",
-  "review_url"
-]New value: +[
+  "status",
+  "batch_id",
+  "created",
+  "bundle_count",
+  "review_path",
+  "review_url",
+  "review_flags"
+]
  2. Changed1 schema field changed
    • changedInput schema / properties / bundles / items / properties / structured_content / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "definition": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "examples": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "key_points": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "misconceptions": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "claim": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "correction": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "claim",
-            "correction"
-          ],
-          "type": "object"
-        },
-        "maxItems": 12,
-        "type": "array"
-      },
-      "non_examples": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "type": {
-        "const": "concept",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "branches": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "action": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "condition": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "condition",
-            "action"
-          ],
-          "type": "object"
-        },
-        "maxItems": 16,
-        "type": "array"
-      },
-      "done_when": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "failure_modes": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "response": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "symptom": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "symptom",
-            "response"
-          ],
-          "type": "object"
-        },
-        "maxItems": 16,
-        "type": "array"
-      },
-      "goal": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "prerequisites": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "steps": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "detail": {
-              "default": "",
-              "maxLength": 4000,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "title"
-          ],
-          "type": "object"
-        },
-        "maxItems": 30,
-        "type": "array"
-      },
-      "type": {
-        "const": "procedure",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "choice_guide": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "condition": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "recommendation": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "condition",
-            "recommendation"
-          ],
-          "type": "object"
-        },
-        "maxItems": 16,
-        "type": "array"
-      },
-      "commonalities": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "criteria": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "values": {
-              "items": {
-                "maxLength": 4000,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 8,
-              "type": "array"
-            }
-          },
-          "required": [
-            "name",
-            "values"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "type": "array"
-      },
-      "differences": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "targets": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      },
-      "type": {
-        "const": "comparison",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "causes": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "conditions": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "exceptions": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "results": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "stages": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "detail": {
-              "default": "",
-              "maxLength": 4000,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "title"
-          ],
-          "type": "object"
-        },
-        "maxItems": 30,
-        "type": "array"
-      },
-      "type": {
-        "const": "mechanism",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "boundaries": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "components": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "id": {
-              "maxLength": 80,
-              "minLength": 1,
-              "pattern": "^[A-Za-z0-9._:-]+$",
-              "type": "string"
-            },
-            "label": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "parent_id": {
-              "maxLength": 80,
-              "minLength": 1,
-              "pattern": "^[A-Za-z0-9._:-]+$",
-              "type": "string"
-            },
-            "role": {
-              "default": "",
-              "maxLength": 4000,
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "label"
-          ],
-          "type": "object"
-        },
-        "maxItems": 40,
-        "type": "array"
-      },
-      "purpose": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "relations": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "label": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "source_id": {
-              "maxLength": 80,
-              "minLength": 1,
-              "type": "string"
-            },
-            "target_id": {
-              "maxLength": 80,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "source_id",
-            "target_id",
-            "label"
-          ],
-          "type": "object"
-        },
-        "maxItems": 60,
-        "type": "array"
-      },
-      "type": {
-        "const": "structure",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "claim": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "confidence": {
-        "enum": [
-          "low",
-          "medium",
-          "high"
-        ],
-        "type": "string"
-      },
-      "counterevidence": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "evidence": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "source": {
-              "maxLength": 1000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "statement": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "statement"
-          ],
-          "type": "object"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "limitations": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "scope": {
-        "default": [],
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "type": {
-        "const": "claim_evidence",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "answer_summary": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "context": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "hypotheses": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "known_facts": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "next_steps": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "question": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "status": {
-        "default": "open",
-        "enum": [
-          "open",
-          "answered"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "question",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "criteria": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "decision": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "options": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "tradeoffs": {
-              "default": "",
-              "maxLength": 4000,
-              "type": "string"
-            }
-          },
-          "required": [
-            "name"
-          ],
-          "type": "object"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "outcome": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "rationale": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "reconsider_when": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "type": {
-        "const": "decision",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "causes": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "changes": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "chronology": {
-        "additionalProperties": false,
-        "properties": {
-          "end": {
-            "additionalProperties": false,
-            "properties": {
-              "day": {
-                "maximum": 31,
-                "minimum": 1,
-                "type": "integer"
-              },
-              "era": {
-                "enum": [
-                  "bce",
-                  "ce"
-                ],
-                "type": "string"
-              },
-              "month": {
-                "maximum": 12,
-                "minimum": 1,
-                "type": "integer"
-              },
-              "year": {
-                "maximum": 999999,
-                "minimum": 1,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "year",
-              "era"
-            ],
-            "type": "object"
-          },
-          "precision": {
-            "enum": [
-              "exact",
-              "day",
-              "month",
-              "year",
-              "decade",
-              "century",
-              "approximate",
-              "range"
-            ],
-            "type": "string"
-          },
-          "start": {
-            "additionalProperties": false,
-            "properties": {
-              "day": {
-                "maximum": 31,
-                "minimum": 1,
-                "type": "integer"
-              },
-              "era": {
-                "enum": [
-                  "bce",
-                  "ce"
-                ],
-                "type": "string"
-              },
-              "month": {
-                "maximum": 12,
-                "minimum": 1,
-                "type": "integer"
-              },
-              "year": {
-                "maximum": 999999,
-                "minimum": 1,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "year",
-              "era"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "start",
-          "precision"
-        ],
-        "type": "object"
-      },
-      "consequences": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "context": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "event": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "occurred_at": {
-        "default": "",
-        "maxLength": 500,
-        "type": "string"
-      },
-      "type": {
-        "const": "event",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "common_mistakes": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "correction": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "incorrect": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "incorrect",
-            "correction"
-          ],
-          "type": "object"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "contrasts": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "difference": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "expression": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "expression",
-            "difference"
-          ],
-          "type": "object"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "examples": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "note": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "text": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            },
-            "translation": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "text"
-          ],
-          "type": "object"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "expression": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "language": {
-        "maxLength": 255,
-        "minLength": 2,
-        "type": "string"
-      },
-      "meanings": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "nuance": {
-        "default": "",
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "pronunciation": {
-        "default": "",
-        "maxLength": 500,
-        "type": "string"
-      },
-      "register": {
-        "default": "",
-        "maxLength": 500,
-        "type": "string"
-      },
-      "translations": {
-        "default": [],
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "language": {
-              "maxLength": 255,
-              "minLength": 2,
-              "type": "string"
-            },
-            "text": {
-              "maxLength": 4000,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "language",
-            "text"
-          ],
-          "type": "object"
-        },
-        "maxItems": 24,
-        "type": "array"
-      },
-      "type": {
-        "const": "expression",
-        "type": "string"
-      },
-      "usage_contexts": {
-        "default": [],
-        "items": {
-          "maxLength": 6000,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 24,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "language"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "definition": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "examples": {
+        "default": [],
+        "description": "Concrete instances of this concept; explain why each fits. Prefer one concise example supported by the selected material when useful; otherwise use an empty array.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "key_points": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "misconceptions": {
+        "default": [],
+        "description": "Misconceptions and corrections as {claim, correction} pairs: a mistaken interpretation and its accurate replacement with a brief reason. Include only when supported by the selected material; otherwise use an empty array. Never attribute a misconception to the user or fabricate evidence.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "claim": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "correction": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "claim",
+            "correction"
+          ],
+          "type": "object"
+        },
+        "maxItems": 12,
+        "type": "array"
+      },
+      "non_examples": {
+        "default": [],
+        "description": "Nearby cases that do not meet the definition; explain the distinguishing boundary. Include only when supported by the selected material and useful; otherwise use an empty array.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "type": {
+        "const": "concept",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "branches": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "action": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "condition": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "action"
+          ],
+          "type": "object"
+        },
+        "maxItems": 16,
+        "type": "array"
+      },
+      "done_when": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "failure_modes": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "response": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "symptom": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "symptom",
+            "response"
+          ],
+          "type": "object"
+        },
+        "maxItems": 16,
+        "type": "array"
+      },
+      "goal": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "prerequisites": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "steps": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "detail": {
+              "default": "",
+              "maxLength": 4000,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "title"
+          ],
+          "type": "object"
+        },
+        "maxItems": 30,
+        "type": "array"
+      },
+      "type": {
+        "const": "procedure",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "choice_guide": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "recommendation": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "recommendation"
+          ],
+          "type": "object"
+        },
+        "maxItems": 16,
+        "type": "array"
+      },
+      "commonalities": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "criteria": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "values": {
+              "items": {
+                "maxLength": 4000,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 8,
+              "type": "array"
+            }
+          },
+          "required": [
+            "name",
+            "values"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      },
+      "differences": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "targets": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      },
+      "type": {
+        "const": "comparison",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "causes": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "conditions": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "exceptions": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "results": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "stages": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "detail": {
+              "default": "",
+              "maxLength": 4000,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "title"
+          ],
+          "type": "object"
+        },
+        "maxItems": 30,
+        "type": "array"
+      },
+      "type": {
+        "const": "mechanism",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "boundaries": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "components": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "maxLength": 80,
+              "minLength": 1,
+              "pattern": "^[A-Za-z0-9._:-]+$",
+              "type": "string"
+            },
+            "label": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "parent_id": {
+              "maxLength": 80,
+              "minLength": 1,
+              "pattern": "^[A-Za-z0-9._:-]+$",
+              "type": "string"
+            },
+            "role": {
+              "default": "",
+              "maxLength": 4000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "label"
+          ],
+          "type": "object"
+        },
+        "maxItems": 40,
+        "type": "array"
+      },
+      "purpose": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "relations": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "label": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "source_id": {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            "target_id": {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "source_id",
+            "target_id",
+            "label"
+          ],
+          "type": "object"
+        },
+        "maxItems": 60,
+        "type": "array"
+      },
+      "type": {
+        "const": "structure",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "claim": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "confidence": {
+        "enum": [
+          "low",
+          "medium",
+          "high"
+        ],
+        "type": "string"
+      },
+      "counterevidence": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "evidence": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "source": {
+              "maxLength": 1000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "statement": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "statement"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "limitations": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "scope": {
+        "default": [],
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "type": {
+        "const": "claim_evidence",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "answer_summary": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "context": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "hypotheses": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "known_facts": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "next_steps": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "question": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "status": {
+        "default": "open",
+        "enum": [
+          "open",
+          "answered"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "question",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "criteria": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "decision": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "options": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "tradeoffs": {
+              "default": "",
+              "maxLength": 4000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "outcome": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "rationale": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "reconsider_when": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "type": {
+        "const": "decision",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "causes": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "changes": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "chronology": {
+        "additionalProperties": false,
+        "properties": {
+          "end": {
+            "additionalProperties": false,
+            "properties": {
+              "day": {
+                "maximum": 31,
+                "minimum": 1,
+                "type": "integer"
+              },
+              "era": {
+                "enum": [
+                  "bce",
+                  "ce"
+                ],
+                "type": "string"
+              },
+              "month": {
+                "maximum": 12,
+                "minimum": 1,
+                "type": "integer"
+              },
+              "year": {
+                "maximum": 999999,
+                "minimum": 1,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "year",
+              "era"
+            ],
+            "type": "object"
+          },
+          "precision": {
+            "enum": [
+              "exact",
+              "day",
+              "month",
+              "year",
+              "decade",
+              "century",
+              "approximate",
+              "range"
+            ],
+            "type": "string"
+          },
+          "start": {
+            "additionalProperties": false,
+            "properties": {
+              "day": {
+                "maximum": 31,
+                "minimum": 1,
+                "type": "integer"
+              },
+              "era": {
+                "enum": [
+                  "bce",
+                  "ce"
+                ],
+                "type": "string"
+              },
+              "month": {
+                "maximum": 12,
+                "minimum": 1,
+                "type": "integer"
+              },
+              "year": {
+                "maximum": 999999,
+                "minimum": 1,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "year",
+              "era"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "start",
+          "precision"
+        ],
+        "type": "object"
+      },
+      "consequences": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "context": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "event": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "occurred_at": {
+        "default": "",
+        "maxLength": 500,
+        "type": "string"
+      },
+      "type": {
+        "const": "event",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "common_mistakes": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "correction": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "incorrect": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "incorrect",
+            "correction"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "contrasts": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "difference": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "expression": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "expression",
+            "difference"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "examples": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "note": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "text": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "translation": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "text"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "expression": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "language": {
+        "maxLength": 255,
+        "minLength": 2,
+        "type": "string"
+      },
+      "meanings": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "nuance": {
+        "default": "",
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "pronunciation": {
+        "default": "",
+        "maxLength": 500,
+        "type": "string"
+      },
+      "register": {
+        "default": "",
+        "maxLength": 500,
+        "type": "string"
+      },
+      "translations": {
+        "default": [],
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "language": {
+              "maxLength": 255,
+              "minLength": 2,
+              "type": "string"
+            },
+            "text": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "language",
+            "text"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      },
+      "type": {
+        "const": "expression",
+        "type": "string"
+      },
+      "usage_contexts": {
+        "default": [],
+        "items": {
+          "maxLength": 6000,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 24,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "language"
+    ],
+    "type": "object"
+  }
+]
  3. Changed4 schema fields changed
    • addedInput schema / properties / bundles / items / properties / resolution_proposal
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "action": {
+      "enum": [
+        "save_new",
+        "merge",
+        "update"
+      ],
+      "type": "string"
+    },
+    "change_summary": {
+      "additionalProperties": false,
+      "properties": {
+        "added": {
+          "default": [],
+          "items": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "maxItems": 50,
+          "type": "array"
+        },
+        "changed": {
+          "default": [],
+          "items": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "maxItems": 50,
+          "type": "array"
+        },
+        "conflicts": {
+          "default": [],
+          "items": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "maxItems": 50,
+          "type": "array"
+        },
+        "preserved": {
+          "default": [],
+          "items": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "maxItems": 50,
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "expected_target_version": {
+      "maximum": 9007199254740991,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "reason": {
+      "maxLength": 1000,
+      "minLength": 1,
+      "type": "string"
+    },
+    "source_item_ids": {
+      "items": {
+        "maxLength": 160,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9._:-]+$",
+        "type": "string"
+      },
+      "maxItems": 50,
+      "minItems": 1,
+      "type": "array"
+    },
+    "target_item_id": {
+      "maxLength": 160,
+      "minLength": 1,
+      "pattern": "^[A-Za-z0-9._:-]+$",
+      "type": "string"
+    }
+  },
+  "required": [
+    "action",
+    "source_item_ids",
+    "change_summary",
+    "reason"
+  ],
+  "type": "object"
+}
    • addedInput schema / properties / provenance / properties / client_version
      Added value: +{
+  "maxLength": 160,
+  "minLength": 1,
+  "type": "string"
+}
    • addedInput schema / properties / provenance / properties / reported_agent
      Added value: +{
+  "maxLength": 160,
+  "minLength": 1,
+  "type": "string"
+}
    • addedInput schema / properties / provenance / properties / reported_model
      Added value: +{
+  "maxLength": 160,
+  "minLength": 1,
+  "type": "string"
+}
  4. Changed2 schema fields changed
    • addedOutput schema / properties / review_url
      Added value: +{
+  "format": "uri",
+  "maxLength": 2048,
+  "type": "string"
+}
    • changedOutput schema / required
      Previous value: -[
-  "status",
-  "batch_id",
-  "created",
-  "bundle_count",
-  "review_path"
-]New value: +[
+  "status",
+  "batch_id",
+  "created",
+  "bundle_count",
+  "review_path",
+  "review_url"
+]
  5. Changed2 schema fields changed
    • addedInput schema / properties / bundles / items / properties / tag_ids
      Added value: +{
+  "items": {
+    "maxLength": 160,
+    "minLength": 1,
+    "pattern": "^[A-Za-z0-9._:-]+$",
+    "type": "string"
+  },
+  "maxItems": 12,
+  "type": "array"
+}
    • addedInput schema / properties / bundles / items / properties / topic_id
      Added value: +{
+  "maxLength": 160,
+  "minLength": 1,
+  "pattern": "^[A-Za-z0-9._:-]+$",
+  "type": "string"
+}
  6. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false and idempotentHint=true, so the mutation/idempotency profile is known. The description adds real value beyond them: drafts are pending and user-owned, the tool 'cannot approve drafts, retain transcripts, or modify public knowledge,' and decisions/organization-specific material are rejected.

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 dense sentences that are front-loaded with the create action and consent gate before the scope and prohibition clauses. Nothing is wasted, though the consent phrase is verbose and slightly convoluted.

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

Completeness4/5

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

An output schema exists, so return values need not be explained, and the deep nested schema documents the bundle contents. Given that, the description appropriately concentrates on the governance constraints an agent could not infer, though it leaves the required top-level request envelope undocumented.

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?

Top-level schema description coverage is 0%, so the description must carry parameter meaning, and it does cover the two most consequential fields: knowledge_scope must be general_knowledge, and the allowed knowledge_type values are enumerated. It says nothing about provider, request_id, provenance, or the bundles array/evidence-selector structure, so the gap is only partially compensated.

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?

States a specific verb and resource ('Create ... knowledge-bundle drafts') and enumerates the supported knowledge types, so the agent knows exactly what is produced. It is somewhat less explicit about how it differs from siblings like create_card_drafts, preview_knowledge_bundle, or save_guest_knowledge_bundles, which is the only thing keeping this from a 5.

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?

Gives a clear precondition: creation is allowed 'only after clear affirmative consent to specifically named, independently teachable general knowledge in the current conversation,' and it explicitly rules out assistant-suggested-only consent. It does not, however, name alternative tools or say when to prefer preview/validate over direct draft creation.

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

All MemoStem toolsInspect
Try in Browser
Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources