> ## 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.

# Overview

# MCP Overview

Nylio exposes a hosted Model Context Protocol transport over HTTP.

## Endpoint

```txt theme={null}
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:

```txt theme={null}
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.