Atisbo

atisbo_lookup

Read-only

Find or open Atisbo entities. Modes expose snippet text + attachment URLs, queues, outcomes and implementation context.

Input Schema

TableJSON Schema

Name	Required	Description
`ref`	No	open: a handle ref (claim:UUID, snippet://UUID).
`mode`	Yes	Named by its enum value; notes per mode in meta.guidance.
`refs`	No	open: several refs (max 10).
`type`	No	claims: classification.
`view`	No	work_queue: one whole bucket by whose move it is.
`depth`	No	summary (alias: brief) = compact fields; work = full context (default).
`focus`	No	claims: agent_work \| all.
`limit`	No	Max results (1–200); page with next_cursor.
`query`	No	Topic search: claims/solutions/knowledge/context; resolve: name→id.
`scope`	No	Scope for context / living_doc list.
`state`	No	work tokens (todo=DESIGNING, active=agent-consumable) or post-launch kinds.
`types`	No	resolve: entity kinds.
`cursor`	No	Pagination cursor from a previous response.
`entity`	No	get: which entity kind the id field carries. Omit — the id field names the entity.
`map_id`	No	Map UUID (mode=get).
`status`	No	Status filter.
`node_id`	No	Node UUID (get; claims/solutions filter).
`sort_by`	No	Solution order (priority = evidence-weighted × boost).
`anchored`	No	Claim list anchoring filter.
`category`	No	knowledge: exact category filter.
`claim_id`	No	Claim UUID — resolve names with atisbo_lookup mode=resolve first
`scope_id`	No	Scope UUID unless scope/scope_type is company/workspace.
`lifecycle`	No	Solution lifecycle filters.
`target_id`	No	UUID for claim/solution/node/map/doc.
`command_id`	No	receipts: probe ONE write — the exact key on a listed receipt; omit for your 25 latest.
`scope_type`	No	Alias of scope (either name works); workspace is treated as company.
`claim_state`	No	Claim state; open=untouched.
`debug_score`	No	get claim: PowerScore breakdown.
`document_id`	No	Living document UUID.
`review_kind`	No	unreviewed only (see atisbo_decide mode=mark_reviewed).
`solution_id`	No	Solution UUID — resolve names with atisbo_lookup mode=resolve first
`action_cursor`	No	work_queue action_queue cursor; restart at page 1 after a mutation.
`content_limit`	No
`include_stale`	No	claims: include stale claims.
`content_offset`	No
`dirty_event_id`	No	doc_patch_context: loads this event's snippets.
`evidence_limit`	No	get entity=claim: evidence rows on page one (1–25); cursor reaches the rest.
`exception_cursor`	No	pages pm_exceptions.
`judgement_cursor`	No	pages needs_judgement.
`operational_block_cursor`	No	work_queue: pages operational_blocks.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedSep 30, 2026

changedInput schema / properties / limit / description

Previous value: -"Max results; delegates clamp per page. Page with next_cursor."New value: +"Max results (1–200); page with next_cursor."

addedInput schema / properties / limit / maximum
```
Added value: +200
```

Changed1 schema field changedSep 30, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "result": {}
+  },
+  "required": [
+    "result"
+  ],
+  "type": "object"
+}

Changed1 schema field changedSep 27, 2026

addedInput schema / properties / view

Added value: +{
+  "description": "work_queue: one whole bucket by whose move it is.",
+  "enum": [
+    "executable",
+    "propose",
+    "needs_pm"
+  ],
+  "type": "string"
+}

Changed11 schema fields changedSep 27, 2026
- removedInput schema / properties / action_cursor / minLength
```
Removed value: -1
```
- removedInput schema / properties / category / minLength
```
Removed value: -1
```
- removedInput schema / properties / command_id / minLength
```
Removed value: -1
```
- removedInput schema / properties / cursor / minLength
```
Removed value: -1
```
- removedInput schema / properties / exception_cursor / minLength
```
Removed value: -1
```
- removedInput schema / properties / judgement_cursor / minLength
```
Removed value: -1
```
- removedInput schema / properties / lifecycle / minItems
```
Removed value: -1
```
- removedInput schema / properties / limit / maximum
```
Removed value: -9007199254740991
```
- removedInput schema / properties / operational_block_cursor / minLength
```
Removed value: -1
```
- removedInput schema / properties / refs / minItems
```
Removed value: -1
```
- removedInput schema / properties / types / minItems
```
Removed value: -1
```

Changed3 schema fields changedSep 27, 2026

changedInput schema / properties / map_id / description

Previous value: -"Map UUID — mode=get targets it when entity=map."New value: +"Map UUID (mode=get)."

changedInput schema / properties / node_id / description

Previous value: -"Node UUID — mode=get targets it when entity=node."New value: +"Node UUID (get; claims/solutions filter)."

changedInput schema / properties / query / description

Previous value: -"Search text (resolve/context)"New value: +"Topic search: claims/solutions/knowledge/context; resolve: name→id."

Changed1 schema field changedSep 26, 2026

changedInput schema / properties / command_id / description

Previous value: -"receipts: probe ONE write — your Idempotency-Key or the jsonrpc:N implicit key; omit for your 25 latest."New value: +"receipts: probe ONE write — the exact key on a listed receipt; omit for your 25 latest."

Changed3 schema fields changedSep 26, 2026
- addedInput schema / properties / content_limit
```
Added value: +{
+  "type": "number"
+}
```
- addedInput schema / properties / content_offset
```
Added value: +{
+  "type": "number"
+}
```
- changedInput schema / properties / status / description
```
Previous value: -"Status filter — active/all/archived."New value: +"Status filter."
```
Changed2 schema fields changedSep 26, 2026
- addedInput schema / properties / limit / maximum
```
Added value: +9007199254740991
```
- addedInput schema / properties / limit / minimum
```
Added value: +1
```

Changed4 schema fields changedSep 26, 2026

changedInput schema / properties / category / description

Previous value: -"knowledge: exact category filter. ≤60 chars."New value: +"knowledge: exact category filter."

changedInput schema / properties / command_id / description

Previous value: -"receipts: probe ONE write — your Idempotency-Key or the jsonrpc:N implicit key. Omit for your 25 latest writes."New value: +"receipts: probe ONE write — your Idempotency-Key or the jsonrpc:N implicit key; omit for your 25 latest."

changedInput schema / properties / entity / description

Previous value: -"get: which entity kind the id field carries. Omit it — the id field you already sent names the entity."New value: +"get: which entity kind the id field carries. Omit — the id field names the entity."

changedInput schema / properties / limit / description

Previous value: -"Max results. Delegates cap what fits one page: claims clamp to 30, orphans to 50; others self-cap. Page with next_cursor."New value: +"Max results; delegates clamp per page. Page with next_cursor."

Changed1 schema field changedSep 26, 2026

changedInput schema / properties / query / description

Previous value: -"Search text (resolve/context)."New value: +"Search text (resolve/context)"

Changed17 schema fields changedSep 25, 2026

changedInput schema / properties / claim_state / description

Previous value: -"claims/work_queue Claim state; open=untouched."New value: +"Claim state; open=untouched."

changedInput schema / properties / command_id / description

Previous value: -"receipts: probe ONE write — the Idempotency-Key you sent, or the jsonrpc:N implicit key. Omit for your 25 most recent writes."New value: +"receipts: probe ONE write — your Idempotency-Key or the jsonrpc:N implicit key. Omit for your 25 latest writes."

changedInput schema / properties / debug_score / description

Previous value: -"get entity=claim: PowerScore factor breakdown."New value: +"get claim: PowerScore breakdown."

changedInput schema / properties / evidence_limit / description

Previous value: -"get entity=claim: max evidence rows on page one (1–25); stream cursor reaches the rest."New value: +"get entity=claim: evidence rows on page one (1–25); cursor reaches the rest."

changedInput schema / properties / exception_cursor / description

Previous value: -"work_queue: pages pm_exceptions."New value: +"pages pm_exceptions."

changedInput schema / properties / focus / description

Previous value: -"claims: agent_work (default) | all."New value: +"claims: agent_work | all."

changedInput schema / properties / include_stale / description

Previous value: -"claims: include stale (no snippet in 30d)."New value: +"claims: include stale claims."

changedInput schema / properties / judgement_cursor / description

Previous value: -"work_queue: pages delegation.needs_judgement."New value: +"pages needs_judgement."

changedInput schema / properties / map_id / description

Previous value: -"Map UUID — mode=get targets it when entity is map."New value: +"Map UUID — mode=get targets it when entity=map."

changedInput schema / properties / node_id / description

Previous value: -"Node UUID — mode=get targets it when entity is node."New value: +"Node UUID — mode=get targets it when entity=node."

changedInput schema / properties / ref / description

Previous value: -"open: a handle ref, e.g. claim:UUID or snippet://UUID."New value: +"open: a handle ref (claim:UUID, snippet://UUID)."

changedInput schema / properties / scope_id / description

Previous value: -"Scope UUID unless scope=company."New value: +"Scope UUID unless scope/scope_type is company/workspace."

addedInput schema / properties / scope_type

Added value: +{
+  "description": "Alias of scope (either name works); workspace is treated as company.",
+  "enum": [
+    "company",
+    "workspace",
+    "node",
+    "claim",
+    "solution",
+    "map"
+  ],
+  "type": "string"
+}

changedInput schema / properties / sort_by / description

Previous value: -"Solution list order (priority = evidence-weighted × boost)."New value: +"Solution order (priority = evidence-weighted × boost)."

changedInput schema / properties / state / description

Previous value: -"work tokens (todo=DESIGNING, active=agent-consumable) or post-launch kinds (Backlog UI partition)."New value: +"work tokens (todo=DESIGNING, active=agent-consumable) or post-launch kinds."

changedInput schema / properties / status / description

Previous value: -"Status filter — see guidance for \"archived\"."New value: +"Status filter — active/all/archived."

changedInput schema / properties / target_id / description

Previous value: -"Generic UUID for claim/solution/node/map/doc."New value: +"UUID for claim/solution/node/map/doc."

Changed5 schema fields changedSep 24, 2026

addedInput schema / properties / command_id

Added value: +{
+  "description": "receipts: probe ONE write — the Idempotency-Key you sent, or the jsonrpc:N implicit key. Omit for your 25 most recent writes.",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / properties / evidence_limit / description

Previous value: -"get with entity=claim: max evidence rows on page one (1–25); the stream cursor reaches the rest."New value: +"get entity=claim: max evidence rows on page one (1–25); stream cursor reaches the rest."

changedInput schema / properties / limit / description

Previous value: -"Max results. Delegates cap what fits one deliverable page: claims clamps to 30, orphans to 50; others self-cap. Page with next_cursor."New value: +"Max results. Delegates cap what fits one page: claims clamp to 30, orphans to 50; others self-cap. Page with next_cursor."

changedInput schema / properties / mode / enum

Previous value: -[
-  "open",
-  "resolve",
-  "claims",
-  "get",
-  "similar_claims",
-  "solutions",
-  "outcome_review",
-  "similar_solutions",
-  "work_queue",
-  "orphans",
-  "maps",
-  "context",
-  "knowledge",
-  "living_doc",
-  "attachments",
-  "accounts",
-  "deal_breakers",
-  "doc_patch_context",
-  "implementation_context"
-]New value: +[
+  "open",
+  "resolve",
+  "claims",
+  "get",
+  "similar_claims",
+  "solutions",
+  "outcome_review",
+  "similar_solutions",
+  "work_queue",
+  "orphans",
+  "maps",
+  "context",
+  "knowledge",
+  "living_doc",
+  "attachments",
+  "accounts",
+  "deal_breakers",
+  "doc_patch_context",
+  "implementation_context",
+  "receipts"
+]

changedInput schema / properties / state / description

Previous value: -"work tokens (todo=DESIGNING, active=agent-consumable) or post-launch kinds — the Backlog UI partition."New value: +"work tokens (todo=DESIGNING, active=agent-consumable) or post-launch kinds (Backlog UI partition)."

Changed1 schema field changedSep 23, 2026

changedInput schema / properties / mode / description

Previous value: -"Named by its enum value; mode-specific notes return in meta.guidance after the call."New value: +"Named by its enum value; notes per mode in meta.guidance."

Changed1 schema field changedSep 23, 2026

changedInput schema / properties / limit / description

Previous value: -"Max results; each delegated mode clamps to its own ceiling."New value: +"Max results. Delegates cap what fits one deliverable page: claims clamps to 30, orphans to 50; others self-cap. Page with next_cursor."

Changed6 schema fields changedSep 22, 2026

changedInput schema / properties / debug_score / description

Previous value: -"claim mode: PowerScore factor breakdown."New value: +"get entity=claim: PowerScore factor breakdown."

addedInput schema / properties / entity

Added value: +{
+  "description": "get: which entity kind the id field carries. Omit it — the id field you already sent names the entity.",
+  "enum": [
+    "claim",
+    "solution",
+    "node",
+    "map"
+  ],
+  "type": "string"
+}

changedInput schema / properties / evidence_limit / description

Previous value: -"claim mode: max evidence rows on page one (1–25); the stream cursor reaches the rest."New value: +"get with entity=claim: max evidence rows on page one (1–25); the stream cursor reaches the rest."

changedInput schema / properties / map_id / description

Previous value: -"Map UUID."New value: +"Map UUID — mode=get targets it when entity is map."

changedInput schema / properties / mode / enum

Previous value: -[
-  "open",
-  "resolve",
-  "claims",
-  "claim",
-  "similar_claims",
-  "solutions",
-  "solution",
-  "outcome_review",
-  "similar_solutions",
-  "work_queue",
-  "orphans",
-  "maps",
-  "map",
-  "node",
-  "context",
-  "knowledge",
-  "living_doc",
-  "attachments",
-  "accounts",
-  "deal_breakers",
-  "doc_patch_context",
-  "implementation_context"
-]New value: +[
+  "open",
+  "resolve",
+  "claims",
+  "get",
+  "similar_claims",
+  "solutions",
+  "outcome_review",
+  "similar_solutions",
+  "work_queue",
+  "orphans",
+  "maps",
+  "context",
+  "knowledge",
+  "living_doc",
+  "attachments",
+  "accounts",
+  "deal_breakers",
+  "doc_patch_context",
+  "implementation_context"
+]

changedInput schema / properties / node_id / description

Previous value: -"Node UUID."New value: +"Node UUID — mode=get targets it when entity is node."

Changed1 schema field changedSep 20, 2026

addedInput schema / properties / evidence_limit

Added value: +{
+  "description": "claim mode: max evidence rows on page one (1–25); the stream cursor reaches the rest.",
+  "maximum": 25,
+  "minimum": 1,
+  "type": "number"
+}

Changed1 schema field changedSep 18, 2026

changedInput schema / properties / category / description

Previous value: -"knowledge: exact category filter (case-sensitive); set via atisbo_capture/atisbo_decide mode=knowledge|set_knowledge_category."New value: +"knowledge: exact category filter. ≤60 chars."

Changed1 schema field changedSep 17, 2026

changedInput schema / properties / category / description

Previous value: -"knowledge: filter to documents carrying this exact free-form category label (case-sensitive; set at atisbo_capture mode=knowledge or atisbo_decide mode=set_knowledge_category)."New value: +"knowledge: exact category filter (case-sensitive); set via atisbo_capture/atisbo_decide mode=knowledge|set_knowledge_category."

Changed1 schema field changedSep 17, 2026

addedInput schema / properties / category

Added value: +{
+  "description": "knowledge: filter to documents carrying this exact free-form category label (case-sensitive; set at atisbo_capture mode=knowledge or atisbo_decide mode=set_knowledge_category).",
+  "maxLength": 60,
+  "minLength": 1,
+  "type": "string"
+}

Changed4 schema fields changedSep 16, 2026

addedInput schema / properties / lifecycle / items / enum

Added value: +[
+  "IDEA",
+  "DESIGNING",
+  "IN_DEVELOPMENT",
+  "IN_REVIEW",
+  "LAUNCHED",
+  "CANCELED"
+]

removedInput schema / properties / lifecycle / items / minLength
```
Removed value: -1
```

changedInput schema / properties / state / description

Previous value: -"solutions/work_queue work-state; todo=DESIGNING."New value: +"work tokens (todo=DESIGNING, active=agent-consumable) or post-launch kinds — the Backlog UI partition."

changedInput schema / properties / state / enum

Previous value: -[
-  "active",
-  "todo",
-  "draft",
-  "in_review",
-  "launched"
-]New value: +[
+  "active",
+  "todo",
+  "draft",
+  "in_review",
+  "launched",
+  "monitoring",
+  "needs_review",
+  "came_back",
+  "didnt_work",
+  "partly_worked",
+  "worked",
+  "delivered",
+  "replaced",
+  "canceled"
+]

Changed2 schema fields changedSep 10, 2026

addedInput schema / properties / judgement_cursor

Added value: +{
+  "description": "work_queue: pages delegation.needs_judgement.",
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / properties / review_kind / description

Previous value: -"orphans/claims/solutions: unreviewed only (see atisbo_decide mode=mark_reviewed)."New value: +"unreviewed only (see atisbo_decide mode=mark_reviewed)."

Changed12 schema fields changedSep 9, 2026

changedInput schema / properties / dirty_event_id / description

Previous value: -"doc_patch_context: loads this dirty event's snippets so the patch can resolve it."New value: +"doc_patch_context: loads this event's snippets."

addedInput schema / properties / focus

Added value: +{
+  "description": "claims: agent_work (default) | all.",
+  "enum": [
+    "agent_work",
+    "all"
+  ],
+  "type": "string"
+}

changedInput schema / properties / include_stale / description

Previous value: -"Include stale claims in claims mode."New value: +"claims: include stale (no snippet in 30d)."

changedInput schema / properties / query / description

Previous value: -"Search text for resolve/context modes."New value: +"Search text (resolve/context)."

changedInput schema / properties / refs / description

Previous value: -"open: several handle refs in one call (max 10)."New value: +"open: several refs (max 10)."

changedInput schema / properties / review_kind / description

Previous value: -"orphans/claims/solutions: not-yet-checkpointed entities (atisbo_decide mode=mark_reviewed)."New value: +"orphans/claims/solutions: unreviewed only (see atisbo_decide mode=mark_reviewed)."

changedInput schema / properties / scope / description

Previous value: -"Scope for context mode or living_doc list mode."New value: +"Scope for context / living_doc list."

changedInput schema / properties / scope_id / description

Previous value: -"Scope UUID when scope is not company."New value: +"Scope UUID unless scope=company."

changedInput schema / properties / sort_by / description

Previous value: -"Solution list order; priority = evidence-weighted × PM boost."New value: +"Solution list order (priority = evidence-weighted × boost)."

changedInput schema / properties / status / description

Previous value: -"Status filter — see guidance for what \"archived\" covers."New value: +"Status filter — see guidance for \"archived\"."

changedInput schema / properties / target_id / description

Previous value: -"Generic UUID for claim/solution/node/map/doc reads."New value: +"Generic UUID for claim/solution/node/map/doc."

changedInput schema / properties / types / description

Previous value: -"Entity kinds for resolve mode."New value: +"resolve: entity kinds."

Changed10 schema fields changedSep 9, 2026

changedInput schema / properties / action_cursor / description

Previous value: -"work_queue: action_queue cursor. Restart from page one after each mutation."New value: +"work_queue action_queue cursor; restart at page 1 after a mutation."

changedInput schema / properties / claim_state / description

Previous value: -"work_queue: the three Claim states shown in the UI."New value: +"claims/work_queue Claim state; open=untouched."

changedInput schema / properties / debug_score / description

Previous value: -"For claim mode, include PowerScore factor breakdown."New value: +"claim mode: PowerScore factor breakdown."

changedInput schema / properties / exception_cursor / description

Previous value: -"work_queue: pages pm_exceptions, from pm_exceptions_next_cursor."New value: +"work_queue: pages pm_exceptions."

changedInput schema / properties / operational_block_cursor / description

Previous value: -"work_queue: pages operational_blocks, from operational_blocks_next_cursor."New value: +"work_queue: pages operational_blocks."

changedInput schema / properties / ref / description

Previous value: -"open: a handle ref like claim:UUID, snippet://UUID or document://UUID."New value: +"open: a handle ref, e.g. claim:UUID or snippet://UUID."

changedInput schema / properties / review_kind / description

Previous value: -"orphans/claims/solutions: entities not yet checkpointed (atisbo_decide mode=mark_reviewed)."New value: +"orphans/claims/solutions: not-yet-checkpointed entities (atisbo_decide mode=mark_reviewed)."

changedInput schema / properties / sort_by / description

Previous value: -"Solution list order; priority = evidence-weighted priority × PM boost."New value: +"Solution list order; priority = evidence-weighted × PM boost."

changedInput schema / properties / state / description

Previous value: -"Work-state filter; todo=DESIGNING."New value: +"solutions/work_queue work-state; todo=DESIGNING."

addedInput schema / properties / type

Added value: +{
+  "description": "claims: classification.",
+  "enum": [
+    "problem",
+    "idea",
+    "question",
+    "unclassified"
+  ],
+  "type": "string"
+}

First observedSep 1, 2026

TDQS

C2.5/5.0

Behavior2/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, so the safety profile is covered. The description only gestures vaguely at return content ("snippet text + attachment URLs, queues, outcomes") which overlaps the existing output schema, adding no auth, rate-limit, or mutation-recovery context.

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?

Two short sentences with the verb front-loaded and no wasted words. But the second sentence is a comma-spliced grab-bag that is too terse to organize a 20-mode, 40-parameter surface, so it reads as under-specified rather than efficient.

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 tool with 20 modes and 40 parameters, the description omits the mode taxonomy almost entirely, forcing the agent to infer behavior from enum values alone. Even with a rich output schema, the missing mode-level routing guidance leaves a significant gap.

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 description coverage is 95%, so the schema already documents nearly every parameter thoroughly (including cross-tool hints like "resolve names with atisbo_lookup mode=resolve first"). The description adds no parameter meaning beyond that, so the baseline 3 applies.

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 states a verb+resource ("Find or open Atisbo entities") and lists content types modes can expose. However, with 20 modes ranging from `open` to `receipts`, the purpose is sprawling and the description does nothing to distinguish this tool from siblings like atisbo_orient or atisbo_analyze.

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 guidance appears in the description; it defers entirely to "notes per mode in meta.guidance," an external reference the agent may not have. Nothing tells the agent which of the 20 modes to pick or when to prefer this tool over atisbo_orient/atisbo_analyze.

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

All Atisbo tools Inspect

Try in Browser

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?