All tools
ToolRead

Get Prism workspace context

get_prism_workspace_context

Orient an authorized AI client with the Projects, recent activity, available capabilities, and product boundaries it can use.

When to use it

Start here for almost every Prism task. Use profile essentials when stable ids are already known; use full only when recent objects and routing context are needed.

Typical workflow

Orient first, then choose the smallest task-specific tool.

What it returns

Workspace availability, recent objects, tool routing, or query-focused context.

Avoid using it when

You already have the exact source, draft, post, artifact, or portfolio id.

Advanced input contract

Agent hosts use this JSON Schema to validate the exact input shape.

View full registry notes

Return the canonical compact Prism workspace map for external AI agents: accessible library structure, writing preferences, active draft metadata, recent sources, portfolio/watchlist availability, available tools, and explicit product boundaries. Call this before relying on memory or broad assumptions. Use when: Start here for almost every Prism task. Use profile essentials when stable ids are already known; use full only when recent objects and routing context are needed.

View JSON Schema
{
  "type": "object",
  "properties": {
    "recentLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    },
    "profile": {
      "type": "string",
      "enum": [
        "full",
        "essentials"
      ],
      "default": "essentials",
      "description": "essentials (default) is a small startup payload with scopes, restrictions, folder map, and the tool guide. Use full only when you also need recent objects and richer workflow context."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "workspace",
          "tools",
          "folderIds",
          "library",
          "writing",
          "portfolio",
          "watchlists",
          "agentContext",
          "boundaries"
        ]
      },
      "maxItems": 12,
      "description": "Optional top-level sections to include. folderIds returns compact folder identifiers/names."
    }
  },
  "additionalProperties": false
}

Useful next tools