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

# Nylio developer docs

> Guides for using the Nylio CLI, MCP server, REST API, and enhanced markdown format.

Use these docs to work with Nylio from scripts, local tools, and MCP clients.

## What you can do

<Columns cols={2}>
  <Card title="CLI" icon="terminal" href="/cli/overview">
    Install the CLI, authenticate, and manage documents from your terminal.
  </Card>

  <Card title="MCP" icon="robot" href="/mcp/overview">
    Connect an MCP client to the hosted Streamable HTTP transport.
  </Card>

  <Card title="Nylio markdown" icon="code" href="/format/nylio-markdown">
    Learn the enhanced markdown format used for document reads and writes.
  </Card>

  <Card title="API reference" icon="book" href="/api/overview">
    Browse the REST API and generated endpoint reference.
  </Card>
</Columns>

## Surfaces

| Surface         | Value                                     |
| --------------- | ----------------------------------------- |
| CLI package     | `nylio-cli`                               |
| CLI binary      | `nylio`                                   |
| Public API base | `https://api.nylio.app/api/public/v1`     |
| MCP endpoint    | `https://api.nylio.app/api/public/v1/mcp` |

## Auth model

Both the CLI and MCP transport use OAuth 2.1 with Nylio's Better Auth issuer. For direct API calls and automation, you can also use [API keys](/api/api-keys).

Scopes used by the public platform:

* `workspace:read`
* `document:read`
* `document:write`
* `search:read`

## Start here

* To automate Nylio from a terminal, start with the [CLI overview](/cli/overview).
* To connect an MCP client, start with the [MCP overview](/mcp/overview).
* To read or write document bodies, read the [Nylio markdown guide](/format/nylio-markdown) before using document write tools.