Skip to main content
Glama

Capture: record evidence and patches

atisbo_capture
Destructive

Capture Signals or knowledge; update, patch or add evidence to artefacts.

Tool call template

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

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "mode": "<mode>"
    },
    "name": "atisbo_capture"
  }
}

Input Schema

NameRequiredDescriptionDefault
opsNo
bodyNo
modeYesCapture mode. Notes per mode in meta.guidance. Open string (new modes work with a cached tools/list); unknown mode? invalid_params[].allowed_values names the nearest.
noteNoWhy it matters.
textNoSignal text.
itemsNoBatch; max 100 items.
titleNoKnowledge title.
sourceNoSignal source.
contentNoKnowledge content.
messageNo
node_idNoknowledge: alias for scope_id.
patchesNo
categoryNoknowledge: label hint.
claim_idNoknowledge: alias for scope_id.
documentNosignal: backing doc → claim-scoped Knowledge.
evidenceNoEvidence fields; document_id top-level.
modalityNoQ=Quote, O=Observation, M=Metric; else inferred.
patchOpsNo
scope_idNoTarget scope UUID; required for node/claim/map.
file_nameNo
mime_typeNo
patch_opsNo
agent_nameNo
scope_typeNoScope kind; company = workspace.
attachmentsNo1-5 files; 3 MB combined.
document_idNoLiving document UUID.
solution_idNoknowledge: alias for scope_id.
capture_modeNoKnowledge routing.
captured_fromNo
change_summaryNopatch_artefact requires change_summary (or note): one sentence of what changed.
classificationNoClassification hint.
dirty_event_idNoDirty event
knowledge_kindNo
coverage_updatesNobuckets snippets/ideas/claims; snippets[].{snippet_id,status,rationale}
client_request_idNosignal: retry key.
proposed_solutionNosignal: draft Solution born linked on the claim.
on_behalf_of_personNo
expected_content_hashNodoc_patch_context content_hash
corrects_prior_evidenceNosignal: CORRECTS prior evidence — skips dedup.
expected_patch_lock_hashNodoc_patch_context patch_lock_hash

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"Capture mode. Notes per mode in meta.guidance. Open string, not a closed enum: a mode added after your tools/list was cached still reaches the server; unknown mode? The nearest accepted value and full list answer in invalid_params[].allowed_values."New value: +"Capture mode. Notes per mode in meta.guidance. Open string (new modes work with a cached tools/list); unknown mode? invalid_params[].allowed_values names the nearest."
  2. Changed3 schema fields changed
    • addedInput schema / properties / scope_id / anyOf
      Added value: +[
      +  {
      +    "format": "uuid",
      +    "type": "string"
      +  },
      +  {
      +    "enum": [
      +      "auto"
      +    ],
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / scope_id / format
      Removed value: -"uuid"
    • removedInput schema / properties / scope_id / type
      Removed value: -"string"
  3. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"Capture mode. Notes per mode in meta.guidance. Open string, not a closed enum: a mode added after your tools/list was cached still reaches the server. An unknown mode answers with the nearest accepted value and the full list in invalid_params[].allowed_values."New value: +"Capture mode. Notes per mode in meta.guidance. Open string, not a closed enum: a mode added after your tools/list was cached still reaches the server; unknown mode? The nearest accepted value and full list answer in invalid_params[].allowed_values."
  4. Changed2 schema fields changed
    • changedInput schema / properties / change_summary / description
      Previous value: -"patch_artefact: REQUIRED — change_summary (or note), one sentence of what changed."New value: +"patch_artefact requires change_summary (or note): one sentence of what changed."
    • changedInput schema / properties / proposed_solution / description
      Previous value: -"signal: draft Solution born linked on the clustered claim."New value: +"signal: draft Solution born linked on the claim."
  5. Changed2 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Capture mode. Notes per mode in meta.guidance."New value: +"Capture mode. Notes per mode in meta.guidance. Open string, not a closed enum: a mode added after your tools/list was cached still reaches the server. An unknown mode answers with the nearest accepted value and the full list in invalid_params[].allowed_values."
    • removedInput schema / properties / mode / enum
      Removed value: -[
      -  "signal",
      -  "signal_batch",
      -  "knowledge",
      -  "update_artefact",
      -  "patch_artefact",
      -  "add_artefact_evidence"
      -]
  6. Changed7 schema fields changed
    • changedInput schema / properties / category / description
      Previous value: -"knowledge: label hint ≤60 chars."New value: +"knowledge: label hint."
    • changedInput schema / properties / classification / description
      Previous value: -"Signal classification hint."New value: +"Classification hint."
    • changedInput schema / properties / corrects_prior_evidence / description
      Previous value: -"signal: CORRECTS prior evidence — skips dedup (when/why in meta.guidance)."New value: +"signal: CORRECTS prior evidence — skips dedup."
    • changedInput schema / properties / dirty_event_id / description
      Previous value: -"Dirty event resolved"New value: +"Dirty event"
    • changedInput schema / properties / document_id / description
      Previous value: -"Living document UUID (artefact modes)."New value: +"Living document UUID."
    • addedInput schema / properties / expected_patch_lock_hash
      Added value: +{
      +  "description": "doc_patch_context patch_lock_hash",
      +  "maxLength": 64,
      +  "type": "string"
      +}
    • changedInput schema / properties / scope_id / description
      Previous value: -"Target scope UUID; required for node/claim/map (solution: omit/\"auto\")."New value: +"Target scope UUID; required for node/claim/map."
  7. Changed1 schema field changed
    • addedInput schema / properties / on_behalf_of_person
      Added value: +{
      +  "type": "boolean"
      +}
  8. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"knowledge: free-form category label ≤60 chars."New value: +"knowledge: label hint ≤60 chars."
  9. Changed5 schema fields changed
    • changedInput schema / properties / corrects_prior_evidence / description
      Previous value: -"signal: CORRECTS prior evidence, not a repeat (skips dedup; when/why in meta.guidance)."New value: +"signal: CORRECTS prior evidence — skips dedup (when/why in meta.guidance)."
    • changedInput schema / properties / coverage_updates / description
      Previous value: -"buckets snippets/ideas/claims; snippets[].{snippet_id, status, rationale}"New value: +"buckets snippets/ideas/claims; snippets[].{snippet_id,status,rationale}"
    • addedInput schema / properties / document
      Added value: +{
      +  "description": "signal: backing doc → claim-scoped Knowledge.",
      +  "properties": {
      +    "content": {
      +      "maxLength": 20000,
      +      "minLength": 10,
      +      "type": "string"
      +    },
      +    "file_name": {
      +      "maxLength": 200,
      +      "type": "string"
      +    },
      +    "mime_type": {
      +      "enum": [
      +        "text/html",
      +        "text/markdown"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "content"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / proposed_solution
      Added value: +{
      +  "description": "signal: draft Solution born linked on the clustered claim.",
      +  "properties": {
      +    "description": {
      +      "maxLength": 2000,
      +      "type": "string"
      +    },
      +    "title": {
      +      "maxLength": 200,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / scope_id / description
      Previous value: -"Target scope UUID; required for node/claim/map. On scope_type=solution (mode=knowledge), omit it or pass \"auto\": Atisbo routes the detail to an open Solution."New value: +"Target scope UUID; required for node/claim/map (solution: omit/\"auto\")."
  10. Changed10 schema fields changed
    • changedInput schema / properties / change_summary / description
      Previous value: -"patch_artefact: REQUIRED top-level change_summary (or note) — one sentence of what changed."New value: +"patch_artefact: REQUIRED — change_summary (or note), one sentence of what changed."
    • changedInput schema / properties / claim_id / description
      Previous value: -"knowledge: alias for scope_id (scope_type=claim)."New value: +"knowledge: alias for scope_id."
    • changedInput schema / properties / corrects_prior_evidence / description
      Previous value: -"signal: TRUE to CORRECT prior evidence, not repeat it (skips dedup; when/why in meta.guidance)."New value: +"signal: CORRECTS prior evidence, not a repeat (skips dedup; when/why in meta.guidance)."
    • changedInput schema / properties / dirty_event_id / description
      Previous value: -"Dirty event resolved on success"New value: +"Dirty event resolved"
    • changedInput schema / properties / modality / description
      Previous value: -"Q=Quote, O=Observation, M=Metric; inferred if omitted."New value: +"Q=Quote, O=Observation, M=Metric; else inferred."
    • changedInput schema / properties / node_id / description
      Previous value: -"knowledge: alias for scope_id (scope_type=node)."New value: +"knowledge: alias for scope_id."
    • changedInput schema / properties / note / description
      Previous value: -"Why it matters (signal)."New value: +"Why it matters."
    • changedInput schema / properties / scope_id / description
      Previous value: -"Target scope UUID; required for node/claim/solution/map."New value: +"Target scope UUID; required for node/claim/map. On scope_type=solution (mode=knowledge), omit it or pass \"auto\": Atisbo routes the detail to an open Solution."
    • changedInput schema / properties / scope_type / description
      Previous value: -"Scope kind; company = active workspace."New value: +"Scope kind; company = workspace."
    • changedInput schema / properties / solution_id / description
      Previous value: -"knowledge: alias for scope_id (scope_type=solution)."New value: +"knowledge: alias for scope_id."
  11. Changed4 schema fields changed
    • changedInput schema / properties / capture_mode / description
      Previous value: -"Knowledge routing; default signals_only."New value: +"Knowledge routing."
    • addedInput schema / properties / change_summary / description
      Added value: +"patch_artefact: REQUIRED top-level change_summary (or note) — one sentence of what changed."
    • changedInput schema / properties / client_request_id / description
      Previous value: -"signal: retry key; resend the SAME key to retry."New value: +"signal: retry key."
    • changedInput schema / properties / corrects_prior_evidence / description
      Previous value: -"signal: CORRECTS prior evidence, not repeats it. Records WHICH evidence it corrects (echoed as corrects) and attaches the snippet to that claim."New value: +"signal: TRUE to CORRECT prior evidence, not repeat it (skips dedup; when/why in meta.guidance)."
  12. Changed1 schema field changed
    • changedInput schema / properties / items / description
      Previous value: -"signal_batch, max 100."New value: +"Batch; max 100 items."
  13. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "result": {}
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  14. Changed1 schema field changed
    • removedInput schema / properties / change_summary / description
      Removed value: -"Artefact change summary."
  15. Changed4 schema fields changed
    • addedInput schema / properties / body
      Added value: +{}
    • changedInput schema / properties / content / description
      Previous value: -"Knowledge/artefact content."New value: +"Knowledge content."
    • addedInput schema / properties / message
      Added value: +{}
    • changedInput schema / properties / title / description
      Previous value: -"Knowledge/evidence title."New value: +"Knowledge title."
  16. Changed2 schema fields changed
    • changedInput schema / properties / corrects_prior_evidence / description
      Previous value: -"signal: CORRECTS prior evidence, not repeats it."New value: +"signal: CORRECTS prior evidence, not repeats it. Records WHICH evidence it corrects (echoed as corrects) and attaches the snippet to that claim."
    • addedInput schema / properties / items / items / properties / corrects_prior_evidence
      Added value: +{
      +  "type": "boolean"
      +}
  17. Changed18 schema fields changed
    • removedInput schema / properties / agent_name / minLength
      Removed value: -1
    • removedInput schema / properties / attachments / items / properties / file_name / minLength
      Removed value: -1
    • removedInput schema / properties / attachments / minItems
      Removed value: -1
    • removedInput schema / properties / captured_from / minLength
      Removed value: -1
    • removedInput schema / properties / category / minLength
      Removed value: -1
    • removedInput schema / properties / change_summary / minLength
      Removed value: -1
    • removedInput schema / properties / content / minLength
      Removed value: -1
    • removedInput schema / properties / evidence / properties / provider / minLength
      Removed value: -1
    • removedInput schema / properties / evidence / properties / result_snapshot / properties / event_name / minLength
      Removed value: -1
    • removedInput schema / properties / evidence / properties / title / minLength
      Removed value: -1
    • removedInput schema / properties / evidence / properties / warnings / items / minLength
      Removed value: -1
    • removedInput schema / properties / expected_content_hash / minLength
      Removed value: -1
    • removedInput schema / properties / file_name / minLength
      Removed value: -1
    • removedInput schema / properties / items / minItems
      Removed value: -1
    • removedInput schema / properties / mime_type / minLength
      Removed value: -1
    • removedInput schema / properties / patch_ops / items / properties / markdown / minLength
      Removed value: -1
    • removedInput schema / properties / patch_ops / items / properties / section_id / minLength
      Removed value: -1
    • removedInput schema / properties / title / minLength
      Removed value: -1
  18. Changed5 schema fields changed
    • addedInput schema / properties / coverage_updates / description
      Added value: +"buckets snippets/ideas/claims; snippets[].{snippet_id, status, rationale}"
    • removedInput schema / properties / coverage_updates / properties
      Removed value: -{}
    • removedInput schema / properties / coverage_updates / type
      Removed value: -"object"
    • changedInput schema / properties / note / description
      Previous value: -"Why it matters; ingestion context."New value: +"Why it matters (signal)."
    • changedInput schema / properties / source / description
      Previous value: -"Signal source; default manual."New value: +"Signal source."
  19. Changed5 schema fields changed
    • changedInput schema / properties / attachments / items / properties / data_base64 / description
      Previous value: -"Base64, ≤4200000 chars."New value: +"Base64."
    • removedInput schema / properties / attachments / items / properties / file_name / description
      Removed value: -"Name, ≤200 chars."
    • changedInput schema / properties / items / items / properties / client_request_id / description
      Previous value: -"Idempotency key; max 200 chars."New value: +"Idempotency key."
    • removedInput schema / properties / patch_ops / items / properties / markdown / description
      Removed value: -"Body, ≤20000 chars."
    • removedInput schema / properties / patch_ops / items / properties / section_id / description
      Removed value: -"Section id, ≤64 chars."
  20. Changed16 schema fields changed
    • removedInput schema / properties / agent_name / description
      Removed value: -"Signs the change."
    • changedInput schema / properties / category / description
      Previous value: -"knowledge: free-form category label ≤60 chars. Filter via atisbo_lookup mode=knowledge."New value: +"knowledge: free-form category label ≤60 chars."
    • changedInput schema / properties / claim_id / description
      Previous value: -"knowledge: alias for scope_id when scope_type=claim."New value: +"knowledge: alias for scope_id (scope_type=claim)."
    • addedInput schema / properties / client_request_id
      Added value: +{
      +  "description": "signal: retry key; resend the SAME key to retry.",
      +  "maxLength": 200,
      +  "minLength": 8,
      +  "type": "string"
      +}
    • changedInput schema / properties / content / description
      Previous value: -"Knowledge or artefact content."New value: +"Knowledge/artefact content."
    • changedInput schema / properties / document_id / description
      Previous value: -"Living document UUID for artefact modes."New value: +"Living document UUID (artefact modes)."
    • changedInput schema / properties / evidence / description
      Previous value: -"Evidence fields; document_id is top-level."New value: +"Evidence fields; document_id top-level."
    • changedInput schema / properties / expected_content_hash / description
      Previous value: -"content_hash from doc_patch_context"New value: +"doc_patch_context content_hash"
    • changedInput schema / properties / modality / description
      Previous value: -"Q=Quote, O=Observation, M=Metric. Pipeline infers if omitted."New value: +"Q=Quote, O=Observation, M=Metric; inferred if omitted."
    • changedInput schema / properties / node_id / description
      Previous value: -"knowledge: alias for scope_id when scope_type=node."New value: +"knowledge: alias for scope_id (scope_type=node)."
    • changedInput schema / properties / note / description
      Previous value: -"Why it matters or ingestion context."New value: +"Why it matters; ingestion context."
    • changedInput schema / properties / scope_id / description
      Previous value: -"Target scope UUID — required when scope_type is node/claim/solution/map."New value: +"Target scope UUID; required for node/claim/solution/map."
    • changedInput schema / properties / scope_type / description
      Previous value: -"Scope kind; company is treated as active workspace."New value: +"Scope kind; company = active workspace."
    • changedInput schema / properties / solution_id / description
      Previous value: -"knowledge: alias for scope_id when scope_type=solution."New value: +"knowledge: alias for scope_id (scope_type=solution)."
    • changedInput schema / properties / source / description
      Previous value: -"Signal source. Defaults to manual."New value: +"Signal source; default manual."
    • changedInput schema / properties / title / description
      Previous value: -"Knowledge or evidence title."New value: +"Knowledge/evidence title."
  21. Changed4 schema fields changed
    • removedInput schema / properties / coverage_updates / description
      Removed value: -"Snippet/idea/claim coverage updates."
    • addedInput schema / properties / ops
      Added value: +{}
    • addedInput schema / properties / patchOps
      Added value: +{}
    • addedInput schema / properties / patches
      Added value: +{}
  22. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"knowledge: free-form category/folder label, ≤60 chars. Change via atisbo_decide mode=set_knowledge_category; filter via atisbo_lookup mode=knowledge."New value: +"knowledge: free-form category label ≤60 chars. Filter via atisbo_lookup mode=knowledge."
  23. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"Capture mode. Mode-specific notes return in meta.guidance after the call."New value: +"Capture mode. Notes per mode in meta.guidance."
  24. Changed4 schema fields changed
    • addedInput schema / properties / claim_id
      Added value: +{
      +  "description": "knowledge: alias for scope_id when scope_type=claim.",
      +  "format": "uuid",
      +  "type": "string"
      +}
    • addedInput schema / properties / node_id
      Added value: +{
      +  "description": "knowledge: alias for scope_id when scope_type=node.",
      +  "format": "uuid",
      +  "type": "string"
      +}
    • changedInput schema / properties / scope_id / description
      Previous value: -"Target scope UUID."New value: +"Target scope UUID — required when scope_type is node/claim/solution/map."
    • addedInput schema / properties / solution_id
      Added value: +{
      +  "description": "knowledge: alias for scope_id when scope_type=solution.",
      +  "format": "uuid",
      +  "type": "string"
      +}
  25. Changed8 schema fields changed
    • changedInput schema / properties / category / description
      Previous value: -"knowledge: free-form category/folder label, no claim/node link needed. Change via atisbo_decide mode=set_knowledge_category; filter via atisbo_lookup mode=knowledge."New value: +"knowledge: free-form category/folder label, ≤60 chars. Change via atisbo_decide mode=set_knowledge_category; filter via atisbo_lookup mode=knowledge."
    • changedInput schema / properties / evidence / properties / block_type / description
      Previous value: -"Evidence block kind (default external_insight)."New value: +"Evidence block kind."
    • changedInput schema / properties / evidence / properties / provider / description
      Previous value: -"Provider name, e.g. posthog, amplitude, stripe, hubspot, custom_sql."New value: +"Provider name, e.g. posthog, amplitude, custom_sql."
    • changedInput schema / properties / evidence / properties / query_language / description
      Previous value: -"Language of query_text (default natural_language)."New value: +"Language of query_text."
    • changedInput schema / properties / evidence / properties / query_text / description
      Previous value: -"Query, event name, API request, or natural-language investigation prompt."New value: +"Query, event name, API request, or investigation prompt."
    • changedInput schema / properties / evidence / properties / refresh_policy / description
      Previous value: -"Refresh cadence for the snapshot (default manual)."New value: +"Refresh cadence for the snapshot."
    • changedInput schema / properties / evidence / properties / status / description
      Previous value: -"Relation to the hypothesis (default informational)."New value: +"Relation to the hypothesis."
    • changedInput schema / properties / evidence / properties / title / description
      Previous value: -"Short evidence block title."New value: +"Evidence block title."
  26. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"knowledge: free-form category/folder label the PM controls directly — no claim/node link needed. Change later with atisbo_decide mode=set_knowledge_category; filter with atisbo_lookup mode=knowledge category=."New value: +"knowledge: free-form category/folder label, no claim/node link needed. Change via atisbo_decide mode=set_knowledge_category; filter via atisbo_lookup mode=knowledge."
  27. Changed1 schema field changed
    • addedInput schema / properties / category
      Added value: +{
      +  "description": "knowledge: free-form category/folder label the PM controls directly — no claim/node link needed. Change later with atisbo_decide mode=set_knowledge_category; filter with atisbo_lookup mode=knowledge category=.",
      +  "maxLength": 60,
      +  "minLength": 1,
      +  "type": "string"
      +}
  28. Changed1 schema field changed
    • removedInput schema / properties / patch_ops / minItems
      Removed value: -1
  29. Changed8 schema fields changed
    • addedInput schema / properties / attachments
      Added value: +{
      +  "description": "1-5 files; 3 MB combined.",
      +  "items": {
      +    "description": "PNG/JPG/WebP/PDF; no extraction.",
      +    "properties": {
      +      "data_base64": {
      +        "description": "Base64, ≤4200000 chars.",
      +        "maxLength": 4200000,
      +        "minLength": 4,
      +        "type": "string"
      +      },
      +      "file_name": {
      +        "description": "Name, ≤200 chars.",
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "enum": [
      +          "image/png",
      +          "image/jpeg",
      +          "image/webp",
      +          "application/pdf"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "data_base64",
      +      "file_name",
      +      "mime_type"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 5,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / capture_mode / description
      Previous value: -"Routing; the signals_only default creates no reusable knowledge unless requested."New value: +"Knowledge routing; default signals_only."
    • changedInput schema / properties / change_summary / description
      Previous value: -"Public change description for update_artefact/patch_artefact (patch_artefact accepts note as fallback)."New value: +"Artefact change summary."
    • changedInput schema / properties / content / description
      Previous value: -"Document content — update_artefact fully replaces the doc."New value: +"Knowledge or artefact content."
    • changedInput schema / properties / evidence / description
      Previous value: -"add_artefact_evidence fields; document_id goes at top level. title aliases label, provider aliases kind."New value: +"Evidence fields; document_id is top-level."
    • changedInput schema / properties / items / description
      Previous value: -"signal_batch; max 100 items. Each needs text + client_request_id."New value: +"signal_batch, max 100."
    • changedInput schema / properties / scope_id / description
      Previous value: -"Required for node, claim, solution, and map scopes."New value: +"Target scope UUID."
    • changedInput schema / properties / text / description
      Previous value: -"Raw feedback/signal text (signal mode)."New value: +"Signal text."
  30. First observed

TDQS

C2.4/5.0
Behavior2/5

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

Annotations already declare readOnlyHint=false and destructiveHint=true; the description's 'update, patch' wording is consistent but adds nothing beyond them. It never discloses that the tool is mode-dispatched across ~40 parameters, whether patches are reversible, what an invalid/unknown mode triggers, or that skipped deduplication occurs when correcting prior evidence.

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

Conciseness3/5

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

It is a single economical sentence with no filler, which is structurally clean. However, the compression is achieved by omission rather than by front-loading the discriminating information, so brevity here is under-specification rather than tightness.

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

Completeness2/5

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

For a destructive, 40-parameter, nested-object tool with a required discriminator, the description is far too thin, even granting that the output schema covers return values. It should explain what each mode family does and the preconditions (scope_id, change_summary, concurrency hashes) that make a call succeed.

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

Parameters2/5

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

With 40 parameters at ~70% schema coverage, the description should at least map mode families to parameter groups (signals vs knowledge vs evidence vs patch), but it offers only the vague 'Signals or knowledge'. Idempotency keys, batch `items`, patch-lock/expected-hash concurrency guards, and the dirty-event flow are all unexplained at this level.

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?

The verb 'Capture' is paired with two resource nouns ('Signals or knowledge') plus a trailing list of light mutations ('update, patch or add evidence to artefacts'). This signals it is the write-side sibling of atisbo_analyze/lookup, but 'artefacts' and the difference between 'Signals' and 'knowledge' are never defined, so the agent cannot tell what one call actually produces.

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?

No when-to-use or when-not guidance is given, and no alternative is named; the reader must infer that this is the counterpart to atisbo_lookup/atisbo_decide. Crucially, the description never mentions that a required `mode` selects among radically different behaviors, so an agent has no basis for choosing between capture paths.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources