Skip to main content

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.

Pagination defaults

ConstraintValue
Default limit (list tools)50
Default limit (search)8
Maximum limit (list tools)200
Maximum limit (search)50
Maximum offset950

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:
ParameterDescription
limitMaximum number of results (1—200, default 50)
offsetPagination offset (0—950)
Required scope: workspace:read

documents_list

Lists documents in a workspace. Inputs:
ParameterDescription
workspaceScopepersonal or organization
workspaceSlugSlug of the target workspace
limitMaximum number of results (1—200, default 50)
cursorCursor-based pagination token
offsetOffset-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:
ParameterDescription
idDocument id
urlNylio document URL
workspaceScopepersonal or organization
workspaceSlugSlug 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:
ParameterDescription
titleOptional document title
markdownOptional 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:
ParameterDescription
documentDocument id or URL
oldStringExact string to find in the current body
newStringReplacement 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:
ParameterDescription
documentDocument id or URL
markdownComplete 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:
ParameterDescription
documentDocument id or URL
formatmarkdown, docx, or pdf
fileNameOptional output file name
workspaceScopepersonal or organization
workspaceSlugSlug 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.
Searches documents within a workspace. Inputs:
ParameterDescription
querySearch query string (required, non-empty)
workspaceScopepersonal or organization
workspaceSlugSlug of the target workspace
limitMaximum number of results (1—50, default 8)
offsetPagination offset (0—950)
Required scope: search:read