Skip to main content
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:
ParameterDescription
limitMaximum number of results
offsetPagination offset
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
cursorCursor-based pagination token
offsetOffset-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:
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
workspaceScopepersonal or organization
workspaceSlugSlug of the target workspace
limitMaximum number of results
offsetPagination offset
Required scope: search:read