List pages in a workspace. `path_prefix` narrows by leading segment; `body_contains` keeps pages whose Markdown holds a literal substring; `metadata` keeps pages whose top-level metadata contains the given scalar keys; `sort` (path | updated_at | created_at) and `direction` order the set; `include_metadata` adds each page's metadata. Details: https://carbonforge.dev/docs/p/api/mcp-tools-catalog
Parameterssortlimitcursorinstancemetadatadirectionworkspacepath_prefixbody_containsinclude_metadata
Read a page by path or UUID. Returns the Markdown body plus the page metadata object. Pass `section` with a heading's plain text to get back only that heading and the blocks under it, down to the next heading at the same or shallower level; the result then also carries `section: { heading, level, matches }`. Details: https://carbonforge.dev/docs/p/api/mcp-tools-catalog
ParameterslanesectioninstancepathOrIdrequiredworkspace
List atoms in the current workspace. The `path_prefix`, `body_contains`, `metadata`, `sort`, `direction` and `include_metadata` arguments mirror the same arguments on pages.list.
Parameterssortlimitcursorinstancemetadatadirectionworkspacepath_prefixbody_containsinclude_metadata
Read an atom by path or UUID with usage_pages projection. Returns metadata. Pass `section` with a heading's plain text to get back only that heading and the blocks under it, down to the next heading at the same or shallower level; the result then also carries `section: { heading, level, matches }`, and everything else on it is the atom's own, so a section can be read and written straight back.
ParameterslanesectioninstancepathOrIdrequiredworkspace
Hybrid FTS + pgvector + RRF search. Returns Markdown excerpts.
Parametersqrequiredlimitscopecursorinstanceworkspaceperspective
Exact-substring search over the Markdown projection of pages and atoms — deterministic, unlike hybrid `search.global`. A needle shorter than 3 characters is rejected. Returns one envelope per matched entity, up to 5 hits each as `{ line, col, snippet }`. `case_sensitive` defaults to false; `scope` is workspace | all_mine | all_public. Details: https://carbonforge.dev/docs/p/api/mcp-tools-catalog
Parametersqrequiredkindslimitscopecursorinstanceworkspacecontext_linescase_sensitive
Browse pages or atoms inside a workspace with faceted filters (tag, author, date range, visibility, metadata containment) and sort by alphabetical, recency, or star count. Viewer-aware: members see everything, anonymous callers see only public entities in public workspaces. 50 items per page, cursor-based. Details: https://carbonforge.dev/docs/p/api/mcp-tools-catalog
Parametersqkindrequiredsortlimitcursorfiltersinstanceworkspaceworkspace_idworkspace_slug
Semantic nearest-neighbors via similarity_edges.
ParameterskindrequiredlimitinstancepathOrIdrequiredworkspace
List incoming + outgoing cross-links for a page or atom.
ParameterskindrequiredinstancepathOrIdrequiredworkspace
List revisions for a page or atom (cursor-paginated).
ParameterskindrequiredlimitcursorinstancepathOrIdrequiredworkspace
Fetch a specific revision (returns Markdown body).
ParameterskindrequiredinstancepathOrIdrequiredworkspacerevision_idrequired
Markdown-level diff between two revisions of the same page or atom. Returns segments (op: equal | insert | delete) plus both Markdown projections.
ParameterskindrequiredinstancepathOrIdrequiredworkspacerevision_a_idrequiredrevision_b_idrequired
Fetch metadata for a single media item.
Parametersinstancemedia_idrequiredworkspace
Orientation surface: instance metadata, both grounding documents, identity and capabilities, reachable workspaces, sidecar health. Pass `workspace` to ground a named workspace without moving the per-token pointer. Pass a `known_grounding_at` / `known_workspace_grounding_at` you hold and an unchanged document is acknowledged, not resent. Details: https://carbonforge.dev/docs/p/api/mcp-tools-catalog
Parametersinstanceworkspaceknown_grounding_atknown_workspace_grounding_at
List every workspace the calling user is a member of. This is a membership catalogue and not a capability: it is not narrowed by the token, so a listed workspace may still be outside this token's reach. Call cortex.ground for what this token can actually resolve.
Takes no parameters.
Resolve a workspace slug to its id, role, and archived state. 404 when the caller isn't a member (no enumeration).
Parametersslugrequiredinstance
List instances. Filter: all (default) | public | my | my_admin. public lists an instance that has public reading on, is listed in Discover, is not frozen, and has a workspace that is not private holding a page that is not private. my and my_admin list the caller's own instances (member; admin) with no such gate; all is public plus my. Without a token every filter is public.
Parameterslimitqueryfilter
discovery.list_workspaces
List workspaces across one or all instances, with the same filters. public lists a workspace when its instance has public reading on, the workspace is not private, its instance is listed in Discover and not frozen, and it holds a page that is not private. my and my_admin list the caller's own workspaces with no such gate; all is public plus my. Without a token every filter is public.
Parameterslimitqueryfilterinstance_id
Search instance and workspace metadata + grounding documents. Returns parallel lists for both scopes.
Parametersqrequiredlimitscopefilter
Read a code tree's revision (the current one by default), its metadata and surface, and a page of its entries in path order: path, git mode, size and blob SHA-256, optionally under `path_prefix`. A symlink's blob is its target; a submodule link has no blob and gives its `commit`. With `lane`, `metadata` is the lane's bag if it sets one. Anonymous callers read a public code tree's current one.
Parameterslanelimitoffsetinstanceworkspacepath_or_idrequiredpath_prefixrevision_idsnapshot_id
Browse the workspace as a file tree, one level at a time: directories, pages, atoms, code trees (expanded at their paths) and library entries. Each node names its kind, entity, current revision and digest; `at` holds the entities exactly at `path`. `surface` keeps that surface only. History: files.history. Anonymous callers see public pages and atoms, and code trees of surface code.
Parameterslanepathlimitoffsetsurfaceinstanceworkspaceperspective