# Markbase Help

> Markbase is a hosted Markdown document store reached over MCP. This site
> (help.markbase.cloud) is the user and agent documentation for Markbase:
> how the object model works, how to authenticate, the full MCP tool
> reference, concurrency semantics (ETags), typed collections, _markbase.md
> conventions, and troubleshooting. Every help page is published as both
> rendered HTML (under /humans/...) and plain Markdown (under /agents/....md).

For the fastest path in, start with the agent index — it groups every page
by section with a one-line description:

- [Agent index](https://help.markbase.cloud/agents/index.md): Full
  Markdown index of every page on this site, grouped by section.

The links below are the same pages, listed flat for easy ingestion.

## Getting Started

- [What is Markbase?](https://help.markbase.cloud/agents/getting-started/what-is-markbase.md): Object model, MCP endpoint, and the semantics agents must respect.
- [Quickstart](https://help.markbase.cloud/agents/getting-started/quickstart.md): Minimum MCP-call sequence to read and write a document.
- [Creating Your Account](https://help.markbase.cloud/agents/getting-started/creating-your-account.md): Sign-up flow and first connection.
- [Core Concepts](https://help.markbase.cloud/agents/getting-started/core-concepts.md): Organization, workspace, document, folder, typed collection.

## Workspaces

- [Creating a Workspace](https://help.markbase.cloud/agents/workspaces/creating-a-workspace.md): `create_workspace`, slug rules, optional template cloning.
- [Folders & Organization](https://help.markbase.cloud/agents/workspaces/folders.md): Implicit folders; listing and walking.
- [Workspace Settings](https://help.markbase.cloud/agents/workspaces/settings.md): Workspace-level settings.
- [Deleting a Workspace](https://help.markbase.cloud/agents/workspaces/archiving.md): Deletion semantics and restore window.

## Documents

- [Writing Markdown](https://help.markbase.cloud/agents/documents/writing-markdown.md): Supported Markdown features and round-trip behavior.
- [Frontmatter](https://help.markbase.cloud/agents/documents/frontmatter.md): YAML frontmatter rules and reserved keys.
- [Revisions & History](https://help.markbase.cloud/agents/documents/revisions.md): Immutable revisions; `list_revisions` / `read_doc_at`.
- [Trash & Restore](https://help.markbase.cloud/agents/documents/trash.md): Soft-delete semantics and `restore_doc`.
- [Linking Between Docs](https://help.markbase.cloud/agents/documents/linking.md): Wiki-link syntax and resolution.

## Typed Collections

- [Overview](https://help.markbase.cloud/agents/collections/overview.md): What a typed collection is (`_schema.md` in a folder).
- [Defining a Schema](https://help.markbase.cloud/agents/collections/defining-schema.md): `_schema.md` format and field types.
- [Records & Frontmatter](https://help.markbase.cloud/agents/collections/records.md): UUIDv7 names; `append_record` semantics.
- [Querying Records](https://help.markbase.cloud/agents/collections/querying.md): `query_records` filters, ordering, pagination.
- [Validation Rules](https://help.markbase.cloud/agents/collections/validation.md): What causes a record write to be rejected.

## _markbase.md

- [What is _markbase.md?](https://help.markbase.cloud/agents/markbase-md/overview.md): Per-folder instructions for agents.
- [Workspace Conventions](https://help.markbase.cloud/agents/markbase-md/workspace-conventions.md): Root `_markbase.md` and workspace-wide norms.
- [Per-Folder Instructions](https://help.markbase.cloud/agents/markbase-md/per-folder.md): Nested `_markbase.md` files.
- [Composition Rules](https://help.markbase.cloud/agents/markbase-md/composition.md): Walk order, precedence, conflict resolution.

## MCP Server

- [Installing the MCP Server](https://help.markbase.cloud/agents/mcp/installing.md): Endpoint URL and client registration.
- [Authentication](https://help.markbase.cloud/agents/mcp/authentication.md): OAuth 2.1 + PKCE + DCR; no static tokens.
- [Available Tools](https://help.markbase.cloud/agents/mcp/tools.md): Full tool reference with parameters and return shapes.
- [Working with Claude](https://help.markbase.cloud/agents/mcp/claude.md): Setup for Claude Desktop, Claude Code, and the Claude API.
- [Working with Other Clients](https://help.markbase.cloud/agents/mcp/other-clients.md): Notes for Cursor, Zed, and other MCP clients.

## Search

- [Full-Text Search](https://help.markbase.cloud/agents/search/full-text.md): `search_docs` query syntax and ranking.
- [Filtering by Folder](https://help.markbase.cloud/agents/search/filtering.md): Scoping search to a workspace or subtree.

## Concurrency & Sync

- [ETags & Optimistic Locking](https://help.markbase.cloud/agents/sync/etags.md): `if_match` / `if_absent` write semantics.
- [Conflict Handling](https://help.markbase.cloud/agents/sync/conflicts.md): Recognizing and recovering from write conflicts.

## Team & Access

- [Members & Roles](https://help.markbase.cloud/agents/team/members-and-roles.md): Role definitions and capabilities.
- [Invites](https://help.markbase.cloud/agents/team/invites.md): Invite flow.
- [Settings & Profile](https://help.markbase.cloud/agents/team/settings.md): User-level settings.

## Troubleshooting

- [Sign-In Issues](https://help.markbase.cloud/agents/troubleshooting/sign-in.md): Common OAuth/sign-in failures.
- [MCP Connection](https://help.markbase.cloud/agents/troubleshooting/mcp-connection.md): Diagnosing transport, auth, and tool-list problems.
- [Common Errors](https://help.markbase.cloud/agents/troubleshooting/common-errors.md): API error codes and recovery.

## Reference

- [Glossary](https://help.markbase.cloud/agents/reference/glossary.md): Definitions for terms used across the docs.

## Optional

- [Sitemap (HTML pages)](https://help.markbase.cloud/sitemap.xml): XML sitemap of human-rendered pages.