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.
The hosted MCP server currently exposes nine tools. All tools enforce the pagination defaults and limits described below.
| 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
Agents must call this before constructing documents_create, documents_edit, or documents_replace payloads unless they already read it earlier in the same conversation.
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
Use either cursor or offset, not both.
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
Provide either id or url. Supported URLs include Nylio /app/doc/... and /d/... links.
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 |
Required scope: document:write
Call nylio_markdown_guide first unless you already read it earlier in the same conversation.
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
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.
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 |
Required scope: document:write
Call nylio_markdown_guide first unless you already read it earlier in the same conversation.
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
Markdown is returned directly. DOCX and PDF return compact file metadata over MCP rather than inline base64.
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