Skip to main content
Glama

atisbo_capture

Destructive

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

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
opsNo
bodyNo
modeYesCapture mode. Notes per mode in meta.guidance.
noteNoWhy it matters (signal).
textNoSignal text.
itemsNoBatch; max 100 items.
titleNoKnowledge title.
sourceNoSignal source.
contentNoKnowledge content.
messageNo
node_idNoknowledge: alias for scope_id (scope_type=node).
patchesNo
categoryNoknowledge: free-form category label ≤60 chars.
claim_idNoknowledge: alias for scope_id (scope_type=claim).
evidenceNoEvidence fields; document_id top-level.
modalityNoQ=Quote, O=Observation, M=Metric; inferred if omitted.
patchOpsNo
scope_idNoTarget scope UUID; required for node/claim/solution/map.
file_nameNo
mime_typeNo
patch_opsNo
agent_nameNo
scope_typeNoScope kind; company = active workspace.
attachmentsNo1-5 files; 3 MB combined.
document_idNoLiving document UUID (artefact modes).
solution_idNoknowledge: alias for scope_id (scope_type=solution).
capture_modeNoKnowledge routing.
captured_fromNo
change_summaryNopatch_artefact: REQUIRED top-level change_summary (or note) — one sentence of what changed.
classificationNoSignal classification hint.
dirty_event_idNoDirty event resolved on success
knowledge_kindNo
coverage_updatesNobuckets snippets/ideas/claims; snippets[].{snippet_id, status, rationale}
client_request_idNosignal: retry key.
expected_content_hashNodoc_patch_context content_hash
corrects_prior_evidenceNosignal: TRUE to CORRECT prior evidence, not repeat it (skips dedup; when/why in meta.guidance).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. 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)."
  2. Changed1 schema field changed
    • changedInput schema / properties / items / description
      Previous value: -"signal_batch, max 100."New value: +"Batch; max 100 items."
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "result": {}
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • removedInput schema / properties / change_summary / description
      Removed value: -"Artefact change summary."
  5. 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."
  6. 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"
      +}
  7. 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
  8. 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."
  9. 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."
  10. 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."
  11. 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: +{}
  12. 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."
  13. 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."
  14. 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"
      +}
  15. 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."
  16. 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."
  17. 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"
      +}
  18. Changed1 schema field changed
    • removedInput schema / properties / patch_ops / minItems
      Removed value: -1
  19. 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."
  20. First observed

TDQS

C2.3/5.0
Behavior2/5

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

The annotations already declare readOnlyHint=false and destructiveHint=true, so the safety profile is covered. The description adds little beyond those annotations: it says update/patch/add evidence, but does not disclose what gets overwritten, required change summaries, idempotency behavior, or other mutation consequences.

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

Conciseness2/5

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

The single sentence is concise and front-loads the main verb, but it is under-specified for a tool with 36 parameters and six core modes. The brevity is not matched by structure that would help an agent navigate the complex schema.

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?

Given the large nested schema, six required mode values, and destructive write behavior, the description is far too thin to be complete enough for correct invocation. Output schema and annotations cover some burden, but the description never explains the central mode routing or key mode-specific requirements.

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?

The description mentions none of the 36 parameters and does not clarify the required mode, change_summary, scope_id, or mode-specific fields. With schema coverage at 69% and several loosely documented or empty-schema parameters, the description does not compensate for the remaining ambiguity.

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 description names broad operations — capture signals/knowledge, update, patch, add evidence — but does not explain the six required mode values or distinguish among them. It gives a general sense of a multi-mode write tool without enough specificity to select the right mode or separate it from siblings.

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

Usage Guidelines2/5

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

There is no when-to-use, when-not-to-use, or alternative-tool guidance. The description lists operations but leaves mode selection entirely to the schema, with no conditions for choosing between signal, knowledge, update_artefact, patch_artefact, or add_artefact_evidence.

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