The hosted MCP server currently exposes nine tools.
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 |
offset | Pagination offset |
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 |
cursor | Cursor-based pagination token |
offset | Offset-based pagination |
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 |
workspaceScope | personal or organization |
workspaceSlug | Slug of the target workspace |
limit | Maximum number of results |
offset | Pagination offset |
Required scope: search:read