> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nylio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> Reference for all nine tools exposed by the Nylio MCP server.

The hosted MCP server currently exposes nine tools. All tools enforce the pagination defaults and limits described below.

### Pagination defaults

| Constraint                 | Value |
| -------------------------- | ----- |
| Default limit (list tools) | 50    |
| Default limit (search)     | 8     |
| Maximum limit (list tools) | 200   |
| Maximum limit (search)     | 50    |
| Maximum offset             | 950   |

## `nylio_markdown_guide`

Returns the guide for Nylio enhanced markdown.

**Inputs:** none

<Note>
  Agents must call this before constructing `documents_create`, `documents_edit`, or `documents_replace` payloads unless they already read it earlier in the same conversation.
</Note>

## `workspaces_list`

Lists the authenticated user's accessible workspaces.

**Inputs:**

| Parameter | Description                                    |
| --------- | ---------------------------------------------- |
| `limit`   | Maximum number of results (1--200, default 50) |
| `offset`  | Pagination offset (0--950)                     |

**Required scope:** `workspace:read`

## `documents_list`

Lists documents in a workspace.

**Inputs:**

| Parameter        | Description                                    |
| ---------------- | ---------------------------------------------- |
| `workspaceScope` | `personal` or `organization`                   |
| `workspaceSlug`  | Slug of the target workspace                   |
| `limit`          | Maximum number of results (1--200, default 50) |
| `cursor`         | Cursor-based pagination token                  |
| `offset`         | Offset-based pagination (0--950)               |

**Required scope:** `document:read`

<Info>
  Use either `cursor` or `offset`, not both.
</Info>

## `documents_get`

Reads one document and returns metadata plus Nylio enhanced body markdown.

**Inputs:**

| Parameter        | Description                  |
| ---------------- | ---------------------------- |
| `id`             | Document id                  |
| `url`            | Nylio document URL           |
| `workspaceScope` | `personal` or `organization` |
| `workspaceSlug`  | Slug of the target workspace |

**Required scope:** `document:read`

<Info>
  Provide either `id` or `url`. Supported URLs include Nylio `/app/doc/...` and `/d/...` links.
</Info>

## `documents_create`

Creates a new personal document owned by the authenticated user.

**Inputs:**

| Parameter  | Description                                                                |
| ---------- | -------------------------------------------------------------------------- |
| `title`    | Optional document title                                                    |
| `markdown` | Optional initial body in [Nylio enhanced markdown](/format/nylio-markdown) |

**Required scope:** `document:write`

<Note>
  Call `nylio_markdown_guide` first unless you already read it earlier in the same conversation.
</Note>

## `documents_edit`

Applies exactly one string replacement to a personal document owned by the authenticated user.

**Inputs:**

| Parameter   | Description                              |
| ----------- | ---------------------------------------- |
| `document`  | Document id or URL                       |
| `oldString` | Exact string to find in the current body |
| `newString` | Replacement string                       |

**Required scope:** `document:write`

<Warning>
  Call `nylio_markdown_guide` first, then read the document and copy `oldString` verbatim from the latest body. Even a single whitespace difference causes a mismatch.
</Warning>

## `documents_replace`

Replaces the full enhanced markdown body of a personal document owned by the authenticated user.

**Inputs:**

| Parameter  | Description                                                                    |
| ---------- | ------------------------------------------------------------------------------ |
| `document` | Document id or URL                                                             |
| `markdown` | Complete replacement body in [Nylio enhanced markdown](/format/nylio-markdown) |

**Required scope:** `document:write`

<Note>
  Call `nylio_markdown_guide` first unless you already read it earlier in the same conversation.
</Note>

## `documents_export`

Exports one readable document as standard markdown, DOCX, or PDF.

**Inputs:**

| Parameter        | Description                  |
| ---------------- | ---------------------------- |
| `document`       | Document id or URL           |
| `format`         | `markdown`, `docx`, or `pdf` |
| `fileName`       | Optional output file name    |
| `workspaceScope` | `personal` or `organization` |
| `workspaceSlug`  | Slug of the target workspace |

**Required scope:** `document:read`

<Info>
  Markdown is returned directly. DOCX and PDF return compact file metadata over MCP rather than inline base64.
</Info>

## `documents_search`

Searches documents within a workspace.

**Inputs:**

| Parameter        | Description                                  |
| ---------------- | -------------------------------------------- |
| `query`          | Search query string (required, non-empty)    |
| `workspaceScope` | `personal` or `organization`                 |
| `workspaceSlug`  | Slug of the target workspace                 |
| `limit`          | Maximum number of results (1--50, default 8) |
| `offset`         | Pagination offset (0--950)                   |

**Required scope:** `search:read`