Strata Documentation

Strata is an AI-empowered document editing platform. Upload Markdown or HTML documents for viewing, commenting, and editing with a section-based document model designed for granular AI editing via MCP (Model Context Protocol).

SETUP

Quick Start

Connect your AI client to Strata's MCP server to read, edit, search, and manage documents. Most clients handle OAuth automatically — just provide the server URL.

Connection Details

MCP Server URL: https://api.prod.us-east-2.strata.space/mcp
Authentication: OAuth 2.1 with Dynamic Client Registration
Available Tools: app_get_section_content, browse_connector_resources, edit_document, find, get_agent_status, get_document_graph, get_image, get_presence, get_publish_status, invoke_agent, invoke_connector_action, list_connected_tools, manage_comments, manage_suggestions, publish_document, read_document, unpublish_document

INTEGRATION

Client Setup

Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "strata": {
      "url": "https://api.prod.us-east-2.strata.space/mcp"
    }
  }
}

OAuth authentication is handled automatically — you'll be prompted to sign in on first use.

Claude Code

Add the Strata MCP server via the CLI:

bash

claude mcp add strata https://api.prod.us-east-2.strata.space/mcp

OAuth authentication is handled automatically via your browser.

Cursor

Add to ~/.cursor/mcp.json or .cursor/mcp.json:

json

{
  "mcpServers": {
    "strata": {
      "url": "https://api.prod.us-east-2.strata.space/mcp"
    }
  }
}

Cursor handles OAuth automatically when the server returns 401.

VS Code (Copilot)

Add to .vscode/mcp.json in your project:

json

{
  "servers": {
    "strata": {
      "type": "http",
      "url": "https://api.prod.us-east-2.strata.space/mcp"
    }
  }
}

Requires VS Code 1.101+. Uses "servers" (not "mcpServers") and type "http". OAuth with PKCE and Dynamic Client Registration is handled automatically.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json

{
  "mcpServers": {
    "strata": {
      "serverUrl": "https://api.prod.us-east-2.strata.space/mcp"
    }
  }
}

Windsurf uses serverUrl instead of url. OAuth is handled automatically.

Cline

Open the MCP Servers panel in Cline and add to the config:

json

{
  "mcpServers": {
    "strata": {
      "url": "https://api.prod.us-east-2.strata.space/mcp",
      "type": "streamableHttp"
    }
  }
}

Uses "streamableHttp" (camelCase). When OAuth is required, Cline shows an Authenticate button.

Continue

Add to ~/.continue/config.yaml:

yaml

mcpServers:
  - name: strata
    command: npx
    args:
      - "-y"
      - "mcp-remote"
      - "https://api.prod.us-east-2.strata.space/mcp"

Continue does not support OAuth natively yet. Use the mcp-remote bridge instead (see below).

Zed

Add to your Zed settings.json:

json

{
  "context_servers": {
    "strata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.prod.us-east-2.strata.space/mcp"
      ]
    }
  }
}

Zed does not support OAuth natively. Uses mcp-remote as a stdio bridge that handles the OAuth flow in your browser.

FALLBACK

Universal Fallback (mcp-remote)

For any client without native OAuth support, use mcp-remote as a stdio bridge. It handles the full OAuth flow and works with any MCP client:

json

{
  "mcpServers": {
    "strata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.prod.us-east-2.strata.space/mcp"
      ]
    }
  }
}

Auth state is persisted in ~/.mcp-auth/ so you only authenticate once per server.

REFERENCE

Next Steps

See the MCP Tools Reference for complete documentation of all available tools and their parameters.

REFERENCE

Agent frontmatter

An agent definition is a Markdown document under your /Agents folder. The YAML frontmatter declares the agent's identity, tool allowlist, and orchestrator visibility; the body below the frontmatter is the system prompt the orchestrator hands the user's request to verbatim. Every field is validated server-side on save.

Agent frontmatter fields
Field	Type	Required	Default	Description
`autoInvokable`	boolean	Optional	false	When true, the chat orchestrator may pick this agent on its own if its description matches the user's request. When false (default), the agent runs only on explicit invocation (@mention, MCP invoke_agent, or a connected source).
`description`	string	Required	—	One-sentence summary of when to use this agent. Surfaces in the orchestrator's auto-invoke catalog and the @mention picker — be specific about the agent's job.
`enabled`	boolean	Optional	true	Master switch. When false, the agent is hidden from every invocation surface even when its frontmatter is otherwise valid.
`model`	string	Optional	—	Optional override for the model the agent runs on. Falls back to the platform default when omitted. Must resolve against the platform model registry.
`name`	string	Required	—	Kebab-case identifier ([a-z0-9-]), unique within your agents and not colliding with a reserved platform agent name. Drives the @mention token in chat and the agentName argument to MCP invoke_agent.
`tools`	string[]	Optional	[]	Allowlist of platform tools the agent may call (e.g. read_document, search_space). The Available Tools panel inside the agent banner lists every valid name. Omit or leave empty to grant no tools.

Example

markdown

---
name: meeting-notes-summarizer
description: Summarizes meeting notes into a TL;DR with action items.
tools:
  - read_document
  - search_space
model: claude-sonnet-4-6
color: emerald
enabled: true
autoInvokable: false
---

You are a meeting-notes summarizer. Given the document body the
orchestrator hands you verbatim, produce a one-paragraph TL;DR and a
bulleted action-item list…

REFERENCE

Prompt frontmatter

A prompt template is a Markdown document under your /Prompts folder. The YAML frontmatter declares the prompt's name, description, arguments, and orchestrator visibility; the body below the frontmatter is the prompt template — {{argument}} placeholders are substituted at render time. Argument values are collected by the chat composer's slash sheet or the MCP prompts/get request.

Prompt frontmatter fields
Field	Type	Required	Default	Description
`arguments`	PromptArgument[]	Optional	[]	Ordered list of `PromptArgument` entries the prompt body references via `{{name}}` placeholders. Order is preserved across the wire so the slash-picker renders fields in the author's chosen order. Maximum 16 entries.
`autoInvokable`	boolean	Optional	false	When true, the chat orchestrator may pick this prompt on its own when the description matches the user's intent. When false (default), the prompt runs only when the user types its slash token or a client invokes MCP prompts/get.
`description`	string	Required	—	One-sentence summary of what the prompt does. Surfaces in the slash menu, MCP prompts/list, and (when autoInvokable: true) the orchestrator's tool catalog.
`name`	string	Required	—	Human-readable prompt title. The slugified form becomes the /prompt:<slug> token shown in the chat composer's slash menu.

`PromptArgument`

Each entry in the `arguments` array above takes the following shape:

PromptArgument fields
Field	Type	Required	Default	Description
`description`	string	Required	—	Short human-readable description shown in the slash-picker argument sheet, the MCP `prompts/list` payload, and the `loadUserPrompt` catalog so the user (or the model) knows what to fill in. 1-200 chars.
`name`	string	Required	—	Identifier matched verbatim against the body's `{{name}}` placeholders. Matching is case-sensitive — `{{Focus}}` and `{{focus}}` are distinct placeholders. Restricted to ASCII letters, digits, and underscores (1-48 chars) so the same identifier is valid in YAML and the placeholder grammar.
`required`	boolean	Optional	false	When true, the slash-picker argument sheet blocks submit until a value is supplied; the `loadUserPrompt` catalog also flags it so the model knows it must ask the user to clarify. When false (default), an omitted argument substitutes the empty string into its placeholders at render time.

Example

markdown

---
name: Summarize document
description: Summarize the active document for a chosen audience.
autoInvokable: false
arguments:
  - name: focus
    description: What the assistant should focus on.
    required: true
  - name: audience
    description: Target audience for the summary.
    required: false
---

Summarize this document for {{audience}}, focusing on {{focus}}. Keep
the summary under 200 words and finish with a short action-items list.