Wiki

Overview

The wiki tools are read-only tools for searching and reading the entities, concepts, and relationships extracted from your meeting notes:

search_wiki — Keyword search over wiki pages. The entry point: returns ranked pages (pageGuid, name, pageType, relevance) that you pass to the other three tools.
get_wiki_page — A single page’s body (description + generation state) plus metadata and its structured mentions, aliases, and links.
list_wiki_mentions — The note paragraphs that reference a page (where, across your notes, the page is mentioned).
get_wiki_graph — A node+edge slice of the knowledge graph, for traversing how pages connect.

Find a page with search_wiki, check where it came from with list_wiki_mentions, then follow the linked concepts with get_wiki_graph. If you use several workspaces, check each workspace’s guid and whether wiki is enabled with list_workspaces, then pass a workspaceGuid.

Read-only (v1). Creating, renaming, merging, and deleting wiki pages are not supported. For note content, use search_notes or get_note.

Access & the plan gate

Wiki is a paid feature that a workspace must turn on. The tools are always listed, but the plan and the enabled state are checked when you call them. A workspace can use wiki only when both of these are true.

Eligible plan — the workspace’s subscription is Pro, Max, Team, or Enterprise. Free and Lite are not eligible.
Activated — a workspace admin has turned wiki on for the workspace.

When a call is gated, the tool returns an error envelope (HTTP 402) with a machine-readable error_code:

`error_code`	Meaning	What the caller should do
`WIKI_PLAN_REQUIRED`	The plan does not include wiki (Free/Lite/no subscription/inactive).	Upgrade. `action_url` points to the pricing (B2C) or team billing (team admin) page; for a team member it is `null` and the message says to ask an admin.
`WIKI_NOT_ACTIVATED`	The plan is eligible but wiki has not been activated by an admin.	Activate wiki in workspace settings (admin), or ask an admin (member). No upsell — `required_plans` is `null`.

Envelope shape (relayed verbatim from the backend):

{
  "success": false,
  "error_code": "WIKI_PLAN_REQUIRED",
  "message": "위키 기능은 Pro 이상 요금제에서 사용할 수 있어요. 웹에서 로그인 후 요금제를 업그레이드해 주세요.",
  "current_plan": "Lite",
  "required_plans": ["pro", "max", "team", "enterprise"],
  "action_url": "https://tiro.ooo/#pricing",
  "status_code": 402
}

current_plan — the workspace’s current plan display name, or null when there is no subscription.
required_plans — upgrade targets for WIKI_PLAN_REQUIRED; null for WIKI_NOT_ACTIVATED. (Team Free Trial is intentionally excluded — it is an already-held trial, not an upgrade target.)
action_url — a web link to act on, or null when the caller cannot act themselves (team member, or activation by an admin).

Workspace selection. By default the wiki tools resolve the workspace implicitly from your API Key — a workspace-bound or team key resolves directly; a personal or OAuth token resolves to your default workspace — the same way the note tools scope.If your account belongs to multiple workspaces, call list_workspaces to enumerate them (each with its guid and whether wiki is enabled), then pass the chosen workspaceGuid to any wiki tool to target that workspace explicitly. Omitting workspaceGuid keeps the default-workspace behavior. The backend verifies you are a member of the workspace you pass.

`list_workspaces`

List the workspaces your API Key can access, each with its guid, name, and whether wiki is enabled. Use it to pick a workspaceGuid for the wiki tools when your account belongs to more than one workspace. This tool takes no parameters. It returns:

{
  "workspaces": [
    { "guid": "ws_abc", "name": "Acme", "isWikiEnabled": true },
    { "guid": "ws_def", "name": "Personal", "isWikiEnabled": false }
  ]
}

A personal/OAuth token lists every workspace you are a member of; a workspace-bound or team key lists just that one.
isWikiEnabled reflects whether wiki is both plan-eligible and activated for that workspace — pick a workspace where it is true, then pass its guid as workspaceGuid.

`search_wiki`

Search the wiki for pages by keyword. Use this first; pass the returned pageGuid to the other tools.

Parameter	Type	Required	Description
`keyword`	string	Required	Search term matched against page names.
`size`	number	Optional	Max results to return. Has a default; max `100`.
`workspaceGuid`	string	Optional	Target a specific workspace (from `list_workspaces`); omit to use your default workspace.

Returns ranked page results, each with pageGuid, name, pageType (e.g. CONCEPT, ENTITY), and a relevance score.

`get_wiki_page`

Get one wiki page by its pageGuid (from search_wiki).

Parameter	Type	Required	Description
`pageGuid`	string	Required	The page identifier returned by `search_wiki`.
`workspaceGuid`	string	Optional	Target a specific workspace (from `list_workspaces`); omit to use your default workspace.

Returns the page body (description + generation state) and metadata (title, type, mention/alias/link counts, timestamps) plus the page’s structured mentions, aliases, and links. Follow up with list_wiki_mentions to see where the page is referenced across notes.

`list_wiki_mentions`

List the note paragraphs that mention a wiki page.

Parameter	Type	Required	Description
`pageGuid`	string	Required	The page identifier (from `search_wiki` / `get_wiki_page`).
`cursor`	string	Optional	Pagination cursor from a previous response.
`limit`	number	Optional	Max results to return. Max `100`.
`workspaceGuid`	string	Optional	Target a specific workspace (from `list_workspaces`); omit to use your default workspace.

Returns mention records (source note, paragraph, extracted text, kind) plus a pagination cursor.

`get_wiki_graph`

Get a node+edge slice of the wiki knowledge graph. Returns { nodes, edges }, where each edge carries a typed relationship between two pages.

Parameter	Type	Required	Description
`mode`	string	Optional	One of `seed` (default), `expand`, `around`, `links` (see below).
`pageGuid`	string	Conditional	Focus page for `expand` / `around`.
`pageGuids`	string[]	Conditional	Explicit page set for `links`.
`depth`	number	Optional	Traversal depth for `expand`.
`radius`	number	Optional	Neighborhood radius for `around`.
`limit`	number	Optional	Max nodes returned. Default `50`, max `200`.
`q` / `type` / `since`	—	Optional	Overview filters for `seed`.
`folderId`	number	Optional	`seed` only: restrict the graph to pages mentioned by notes in this folder (recursive over subfolders). An empty or inaccessible folder yields an empty graph.
`workspaceGuid`	string	Optional	Target a specific workspace (from `list_workspaces`); omit to use your default workspace.

`mode`	Returns
`seed`	An overview graph for the workspace (optionally filtered by `q` / `type` / `since` / `folderId`).
`expand`	Traversal outward from `pageGuid` by `depth`.
`around`	A page’s neighborhood by `radius`.
`links`	The links among an explicit set of `pageGuids`.

Result cap. get_wiki_graph returns at most limit nodes (default 50, max 200) and only the edges between those returned nodes (dangling edges are dropped, so every edge’s endpoints are present in nodes). When the underlying graph was larger than the cap, the response sets truncated: true — narrow with mode / q / type or a smaller radius / depth to get a focused slice. This keeps a hub page’s neighborhood from returning an unbounded payload.

Cluster-based exploration is not yet exposed. The web app’s newer graph-exploration views (overview/context/cluster) are internal-only; the MCP get_wiki_graph tool exposes the seed / expand / around / links modes. Exposing cluster exploration externally is on the roadmap.

Recommended chains

Pick a workspace first (multiple workspaces): list_workspaces → pass the chosen workspaceGuid to any tool below.
Find what the wiki knows about a topic: search_wiki → get_wiki_page.
Find where a page is grounded in your notes: search_wiki → list_wiki_mentions.
Explore how concepts connect: search_wiki → get_wiki_graph (mode: "around", pageGuid).

Home

Getting Started

API

Voice File

Webhooks

MCP

CLI

Developer Resources

Overview

Access & the plan gate

`list_workspaces`

`search_wiki`

`get_wiki_page`

`list_wiki_mentions`

`get_wiki_graph`

Recommended chains

​Overview

​Access & the plan gate

​list_workspaces

​search_wiki

​get_wiki_page

​list_wiki_mentions

​get_wiki_graph

​Recommended chains

Overview

Access & the plan gate

`list_workspaces`

`search_wiki`

`get_wiki_page`

`list_wiki_mentions`

`get_wiki_graph`

Recommended chains