Skip to main content
Glama

Map: product map nodes and edges

atisbo_map
Destructive

Create/apply maps, generate/edit nodes and edges, anchor claims/snippets, bind metrics, manage claim-snipe maps, regroup (merge/split), build_macros (macros, preview first). Prefer mode=apply for MECE grouping. Anchor and link_claims put a claim on a node differently and both refuse the wrong map kind: anchor sets the TAXONOMY category (auto_node_id); link_claims adds STRUCTURAL-map membership.

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_map"
  }
}

Input Schema

NameRequiredDescriptionDefault
modeYesPer-mode notes in meta.guidance. Open string (new modes work with a cached tools/list); unknown mode? invalid_params[].allowed_values names the nearest.
nameNoMap, node, or metric name.
noteNolink_claims: rationale stored on every link.
labelNo
levelNoNode hierarchy depth.
map_idNoMap UUID.
anchorsNoBatch claim anchors.
edge_idNoEdge UUID for delete_edge mode.
node_idNoNode UUID.
previewNoregroup/build_macros: read-only preview.
branchesNoBranches for apply mode.
claim_idNoClaim UUID (atisbo_lookup mode=resolve)
map_typeNo
providerNoMetric provider: posthog, amplitude, stripe, manual…
templateNo
claim_idsNolink_claims: claims to place under node_id.
directionNoregroup: broader merges; specific splits.
edge_typeNo
new_levelNoNew depth after a move.
parent_idNoParent node UUID.
binding_idNometric_update: binding id (lookup get, metrics[].id).
event_nameNo
snippet_idNo
updated_atNometric_update: updated_at from your last read.
assignmentsNo
descriptionNoMap/node/branch description.
metric_nameNo
metric_typeNo
target_valueNo
current_valueNometric_update: today's value; same-day re-entry replaces it.
grouping_modeNo
new_parent_idNoMove target parent; null promotes to root.
regroup_levelNoregroup broader: merge aggressiveness.
source_map_idNo
branch_optionsNo
source_node_idNo
target_node_idNo
workspace_wideNoregroup: explicit YES to run WORKSPACE-WIDE.
context_answersNoGrounding answers for AI map generation.
historical_dataNometric_update: full series REPLACEMENT.
time_range_daysNo
target_thresholdNoregroup direction=specific: split threshold.

Output Schema

NameRequiredDescriptionDefault
resultNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"Per-mode notes 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: +"Per-mode notes in meta.guidance. Open string (new modes work with a cached tools/list); unknown mode? invalid_params[].allowed_values names the nearest."
  2. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"Per-mode notes 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: +"Per-mode notes 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."
  3. Changed3 schema fields changed
    • changedInput schema / properties / historical_data / description
      Previous value: -"metric_update: full series REPLACEMENT (omit = append now)."New value: +"metric_update: full series REPLACEMENT."
    • changedInput schema / properties / updated_at / description
      Previous value: -"metric_update: updated_at from your last read (stale edits fail)."New value: +"metric_update: updated_at from your last read."
    • changedInput schema / properties / workspace_wide / description
      Previous value: -"regroup: explicit YES to run WORKSPACE-WIDE (refused without)."New value: +"regroup: explicit YES to run WORKSPACE-WIDE."
  4. Changed2 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Per-mode notes in meta.guidance."New value: +"Per-mode notes 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: -[
      -  "apply",
      -  "create",
      -  "rename",
      -  "delete",
      -  "generate_nodes",
      -  "create_node",
      -  "update_node",
      -  "delete_node",
      -  "anchor",
      -  "create_edge",
      -  "delete_edge",
      -  "metric_bind",
      -  "metric_update",
      -  "preview_claim_snipes",
      -  "sync_claim_snipes",
      -  "regroup",
      -  "link_claims",
      -  "build_macros"
      -]
  5. Changed1 schema field changed
    • changedInput schema / properties / preview / description
      Previous value: -"regroup / build_macros: read-only preview: run first."New value: +"regroup/build_macros: read-only preview."
  6. Changed5 schema fields changed
    • changedInput schema / properties / binding_id / description
      Previous value: -"metric_update: binding id (atisbo_lookup mode=get, metrics[].id)."New value: +"metric_update: binding id (lookup get, metrics[].id)."
    • changedInput schema / properties / mode / description
      Previous value: -"Notes per mode in meta.guidance."New value: +"Per-mode notes in meta.guidance."
    • changedInput schema / properties / mode / enum
      Previous value: -[
      -  "apply",
      -  "create",
      -  "rename",
      -  "delete",
      -  "generate_nodes",
      -  "create_node",
      -  "update_node",
      -  "delete_node",
      -  "anchor",
      -  "create_edge",
      -  "delete_edge",
      -  "metric_bind",
      -  "metric_update",
      -  "preview_claim_snipes",
      -  "sync_claim_snipes",
      -  "regroup",
      -  "link_claims"
      -]New value: +[
      +  "apply",
      +  "create",
      +  "rename",
      +  "delete",
      +  "generate_nodes",
      +  "create_node",
      +  "update_node",
      +  "delete_node",
      +  "anchor",
      +  "create_edge",
      +  "delete_edge",
      +  "metric_bind",
      +  "metric_update",
      +  "preview_claim_snipes",
      +  "sync_claim_snipes",
      +  "regroup",
      +  "link_claims",
      +  "build_macros"
      +]
    • changedInput schema / properties / preview / description
      Previous value: -"regroup: read-only preview — ALWAYS run it first."New value: +"regroup / build_macros: read-only preview: run first."
    • changedInput schema / properties / workspace_wide / description
      Previous value: -"regroup: explicit YES to run WORKSPACE-WIDE (refused without it)."New value: +"regroup: explicit YES to run WORKSPACE-WIDE (refused without)."
  7. Changed4 schema fields changed
    • changedInput schema / properties / binding_id / description
      Previous value: -"metric_update: binding to update (atisbo_lookup mode=get, metrics[].id)."New value: +"metric_update: binding id (atisbo_lookup mode=get, metrics[].id)."
    • changedInput schema / properties / claim_id / description
      Previous value: -"Claim UUID (from a name: atisbo_lookup mode=resolve)"New value: +"Claim UUID (atisbo_lookup mode=resolve)"
    • changedInput schema / properties / historical_data / description
      Previous value: -"metric_update: full series REPLACEMENT (omit to append current_value)."New value: +"metric_update: full series REPLACEMENT (omit = append now)."
    • changedInput schema / properties / updated_at / description
      Previous value: -"metric_update: binding updated_at from your last read (stale edits fail)."New value: +"metric_update: updated_at from your last read (stale edits fail)."
  8. Changed1 schema field changed
    • changedInput schema / properties / claim_id / description
      Previous value: -"Claim UUID — resolve names with atisbo_lookup mode=resolve first"New value: +"Claim UUID (from a name: atisbo_lookup mode=resolve)"
  9. Changed6 schema fields changed
    • changedInput schema / properties / direction / description
      Previous value: -"regroup: broader merges similar claims; specific splits them."New value: +"regroup: broader merges; specific splits."
    • changedInput schema / properties / note / description
      Previous value: -"link_claims: why these claims sit under this driver; stored on every link."New value: +"link_claims: rationale stored on every link."
    • changedInput schema / properties / preview / description
      Previous value: -"regroup: read-only preview. ALWAYS preview before executing."New value: +"regroup: read-only preview — ALWAYS run it first."
    • changedInput schema / properties / regroup_level / description
      Previous value: -"regroup direction=broader: merge aggressiveness."New value: +"regroup broader: merge aggressiveness."
    • changedInput schema / properties / target_threshold / description
      Previous value: -"regroup direction=specific: split similarity threshold."New value: +"regroup direction=specific: split threshold."
    • addedInput schema / properties / workspace_wide
      Added value: +{
      +  "description": "regroup: explicit YES to run WORKSPACE-WIDE (refused without it).",
      +  "type": "boolean"
      +}
  10. Changed1 schema field changed
    • removedOutput schema / required
      Removed value: -[
      -  "result"
      -]
  11. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "result": {}
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  12. Changed20 schema fields changed
    • removedInput schema / properties / anchors / minItems
      Removed value: -1
    • removedInput schema / properties / assignments / items / properties / branchKey / minLength
      Removed value: -1
    • removedInput schema / properties / assignments / items / properties / branchName / minLength
      Removed value: -1
    • removedInput schema / properties / assignments / items / properties / branch_key / minLength
      Removed value: -1
    • removedInput schema / properties / assignments / items / properties / branch_name / minLength
      Removed value: -1
    • removedInput schema / properties / bindingId
      Removed value: -{
      -  "description": "Alias for binding_id.",
      -  "format": "uuid",
      -  "type": "string"
      -}
    • removedInput schema / properties / branch_options / items / properties / key / minLength
      Removed value: -1
    • removedInput schema / properties / branch_options / items / properties / label / minLength
      Removed value: -1
    • removedInput schema / properties / branch_options / minItems
      Removed value: -1
    • removedInput schema / properties / branches / items / properties / name / minLength
      Removed value: -1
    • removedInput schema / properties / branches / minItems
      Removed value: -1
    • removedInput schema / properties / claim_ids / minItems
      Removed value: -1
    • removedInput schema / properties / currentValue
      Removed value: -{
      -  "description": "Alias for current_value.",
      -  "type": "number"
      -}
    • removedInput schema / properties / historicalData
      Removed value: -{
      -  "description": "Alias for historical_data.",
      -  "items": {
      -    "properties": {
      -      "date": {
      -        "type": "string"
      -      },
      -      "value": {
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "date",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 365,
      -  "type": "array"
      -}
    • removedInput schema / properties / metric_name / minLength
      Removed value: -1
    • removedInput schema / properties / name / minLength
      Removed value: -1
    • removedInput schema / properties / provider / minLength
      Removed value: -1
    • removedInput schema / properties / time_range_days / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / time_range_days / minimum
      Removed value: --9007199254740991
    • removedInput schema / properties / updatedAt
      Removed value: -{
      -  "description": "Alias for updated_at.",
      -  "format": "date-time",
      -  "type": "string"
      -}
  13. Changed7 schema fields changed
    • changedInput schema / properties / assignments / items / description
      Previous value: -"One snippet per L2 branch: snippet_id + branch_key (branch_name derives)."New value: +"One snippet per L2 branch: snippet_id + branch_key."
    • changedInput schema / properties / binding_id / description
      Previous value: -"metric_update: binding to update — from atisbo_lookup mode=get (metrics[].id)."New value: +"metric_update: binding to update (atisbo_lookup mode=get, metrics[].id)."
    • changedInput schema / properties / direction / description
      Previous value: -"regroup: broader merges similar claims, specific splits claims apart."New value: +"regroup: broader merges similar claims; specific splits them."
    • changedInput schema / properties / historical_data / description
      Previous value: -"metric_update: full series REPLACEMENT. Omit to append current_value instead."New value: +"metric_update: full series REPLACEMENT (omit to append current_value)."
    • changedInput schema / properties / name / description
      Previous value: -"Map, node, or metric name depending on mode."New value: +"Map, node, or metric name."
    • changedInput schema / properties / regroup_level / description
      Previous value: -"For mode=regroup, direction=broader: how aggressively to merge."New value: +"regroup direction=broader: merge aggressiveness."
    • changedInput schema / properties / updated_at / description
      Previous value: -"metric_update: binding updated_at from your last read; concurrent edits fail STALE_DATA."New value: +"metric_update: binding updated_at from your last read (stale edits fail)."
  14. Changed3 schema fields changed
    • changedInput schema / properties / branches / items / properties / description / description
      Previous value: -"Branch description. ≤2000 chars."New value: +"Branch description."
    • changedInput schema / properties / description / description
      Previous value: -"Map/node/branch description. ≤2000 chars."New value: +"Map/node/branch description."
    • changedInput schema / properties / target_threshold / description
      Previous value: -"regroup direction=specific: split similarity threshold (0.50–0.98)."New value: +"regroup direction=specific: split similarity threshold."
  15. Changed6 schema fields changed
    • changedInput schema / properties / current_value / description
      Previous value: -"metric_update: today's value; same-day re-entry replaces, not stacks."New value: +"metric_update: today's value; same-day re-entry replaces it."
    • changedInput schema / properties / historical_data / description
      Previous value: -"metric_update: full series REPLACEMENT. Omit to append current_value as a same-day point instead."New value: +"metric_update: full series REPLACEMENT. Omit to append current_value instead."
    • changedInput schema / properties / preview / description
      Previous value: -"regroup: read-only preview of the merge/split. ALWAYS preview before executing."New value: +"regroup: read-only preview. ALWAYS preview before executing."
    • changedInput schema / properties / provider / description
      Previous value: -"Metric provider, e.g. posthog, amplitude, stripe, manual."New value: +"Metric provider: posthog, amplitude, stripe, manual…"
    • changedInput schema / properties / target_threshold / description
      Previous value: -"For mode=regroup, direction=specific: split similarity threshold (0.50–0.98)."New value: +"regroup direction=specific: split similarity threshold (0.50–0.98)."
    • changedInput schema / properties / updated_at / description
      Previous value: -"metric_update: binding updated_at from your last read; concurrent edits fail STALE_DATA rather than overwrite."New value: +"metric_update: binding updated_at from your last read; concurrent edits fail STALE_DATA."
  16. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"Mode-specific notes return in meta.guidance after the call."New value: +"Notes per mode in meta.guidance."
  17. Changed1 schema field changed
    • changedInput schema / properties / binding_id / description
      Previous value: -"metric_update: binding to update — from atisbo_lookup mode=node (metrics[].id)."New value: +"metric_update: binding to update — from atisbo_lookup mode=get (metrics[].id)."
  18. Changed2 schema fields changed
    • changedInput schema / properties / assignments / items / description
      Previous value: -"One snippet per L2 branch: snippet_id + branch_key; branch_name derives from the key."New value: +"One snippet per L2 branch: snippet_id + branch_key (branch_name derives)."
    • changedInput schema / properties / current_value / description
      Previous value: -"metric_update: today's value; appended as a same-day point when no historical_data (re-entry replaces it, not stacked)."New value: +"metric_update: today's value; same-day re-entry replaces, not stacks."
  19. Changed1 schema field changed
    • addedInput schema / required
      Added value: +[
      +  "mode"
      +]
  20. First observed

TDQS

B3/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true, so the bar is lower, and the description does add real behavior: both anchor and link_claims 'refuse the wrong map kind', and 'preview first' is advised for build_macros. However it never states what a destructive operation actually destroys (nodes, edges, claim links?), whether there is any undo, or the risk implied by workspace_wide — the highest-stakes behaviors are left undisclosed.

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 tightly packed sentences with no filler, and the highest-value disambiguation (anchor vs link_claims) is placed last as a self-contained clause. The opening sentence is a long comma-spliced verb list that is dense to parse, but every clause names a distinct capability rather than restating the name.

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?

The required discriminator 'mode' is never enumerated or explained — the schema only hints that per-mode notes live in meta.guidance, and the description does not mention that path, which is a serious omission for a 42-parameter tool where mode determines everything. Output values are covered by the output schema, but mode discovery and destructive scope remain gaps.

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

Parameters3/5

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

Schema coverage is 62%, so the schema carries much of the load and the baseline applies. The description does add meaningful semantics for the two most confusable parameters (node_id/claim_id across anchor vs link_claims) and for mode=apply, but the remaining ~40 parameters and the mode discriminator itself get nothing beyond the schema.

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 the resource domain (maps, nodes, edges, claims, metrics) and several concrete operations, but it reads as a catalog of a dozen capabilities rather than a single clear verb+resource. An agent can tell it is the 'map/taxonomy manipulation' tool but cannot quickly tell where its boundary lies relative to atisbo_connect or atisbo_lookup, which are never referenced.

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

Usage Guidelines3/5

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

One genuine routing rule is given: 'Prefer mode=apply for MECE grouping', plus a precise when-to-use contrast between anchor (taxonomy maps, sets auto_node_id) and link_claims (structural maps). Beyond those two operations, the many other capabilities (bind metrics, regroup, build_macros, claim-snipe) have no stated conditions or exclusions, and no sibling alternative is ever named.

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