Skip to main content

MCP Overview

Nylio exposes a hosted Model Context Protocol transport over HTTP.

Endpoint

https://api.nylio.app/api/public/v1/mcp

Transport

The server uses Streamable HTTP for the MCP transport.

What it provides

  • A guide for Nylio’s enhanced markdown format
  • Workspace discovery
  • Document listing and reads
  • Personal document edits and full replacements
  • Workspace-scoped document search

Audience and scopes

The MCP transport expects tokens for this audience:
https://api.nylio.app/api/public/v1/mcp
The available scopes are:
  • workspace:read
  • document:read
  • document:write
  • search:read

Important behavior

  • Read and write capabilities are enforced by OAuth scopes.
  • Write tools operate on personal documents owned by the authenticated user.
  • Tool calls return compact text plus minimal structured content.
  • Agents should read nylio_markdown_guide before constructing document write payloads.