MCP tools/Navigation

Navigation & discovery

Every MCP session starts with discovery — listing the orgs the credential can see, walking the workspace/project tree, and resolving an opaque path to a concrete `id`. These tools are read-only and respect the credential's permission scope: a project-scoped key only sees its own project, a global key sees everything the user can see.

Live discovery

Your agent can call searchTools with category: "navigation" to fetch this list at runtime, complete with full input schemas. The page below is the human-readable mirror.

8 tools

Every tool below honours the credential’s permission scope and the user’s org role — agents see only what they’re authorised to call.

  • listOrganisations

    List all orgs the credential can see (single-org for project-scoped keys).

  • listWorkspaces

    List workspaces under an org.

  • listProjects

    List projects under a workspace.

  • getProjectHierarchy

    Full folder + document tree for a project.

  • getFolderHierarchy

    Tree rooted at a given folder.

  • getCurrentUser

    Authenticated user's identity, role, and org membership.

  • listAssignablePrincipals

    Members and teams an agent can assign as task owners or evidence authors.

  • searchTools

    Search the MCP tool catalogue itself by keyword or category.