# Use with AI agents (/docs/ai-agents)



Nylorun publishes Guides as Markdown and the Runtime contracts as OpenAPI.

## MCP [#mcp]

The MCP endpoint is `https://docs.nylorun.com/mcp`. It requires no credentials
and exposes `list_pages`, `get_page`, and `search` over the Guides. For HTTP
routes and schemas, fetch the OpenAPI documents:

| URL                                                    | Document                                                        |
| ------------------------------------------------------ | --------------------------------------------------------------- |
| [`/openapi/runtime.json`](/openapi/runtime.json)       | Runtime API                                                     |
| [`/openapi/management.json`](/openapi/management.json) | Management API                                                  |
| [`/reference`](/reference)                             | Runtime API and Management API, each endpoint with its SDK call |

### Codex [#codex]

```sh
codex mcp add nylorun-docs --url https://docs.nylorun.com/mcp
```

### Claude Code [#claude-code]

```sh
claude mcp add --transport http --scope user nylorun-docs https://docs.nylorun.com/mcp
```

### Gemini CLI [#gemini-cli]

```sh
gemini mcp add --transport http nylorun-docs https://docs.nylorun.com/mcp
```

The **Copy prompt** box on the [Quickstart](/docs) names the same URLs.

## Markdown [#markdown]

| URL                                | Content                                  |
| ---------------------------------- | ---------------------------------------- |
| [`/llms.txt`](/llms.txt)           | Index of Guides pages plus the spec URLs |
| [`/llms-full.txt`](/llms-full.txt) | Every Guides page in one file            |
| `/docs/<page>.md`                  | One Guides page                          |

For example, [`/docs/build/tools.md`](/docs/build/tools.md). Clients may also
request a documentation URL with `Accept: text/markdown`.

## JSON Schemas [#json-schemas]

A manifest's files, and saved manifests, name these schemas in `$schema`, so an
editor or a coding agent can check them:

| URL                                                                                    | Schema                                                                                         |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| [`/schemas/agent-folder/v1/agent-md.4.json`](/schemas/agent-folder/v1/agent-md.4.json) | The frontmatter of an agent manifest's `AGENT.md`                                              |
| [`/schemas/agent-folder/v1/trigger-md.json`](/schemas/agent-folder/v1/trigger-md.json) | The frontmatter of a `triggers/<id>.md` file                                                   |
| [`/schemas/agent-folder/v1/runtime.2.json`](/schemas/agent-folder/v1/runtime.2.json)   | An agent manifest's `runtime.json`                                                             |
| [`/schemas/agent-folder/v1/tool.json`](/schemas/agent-folder/v1/tool.json)             | A `tools/<name>.json` file                                                                     |
| [`/schemas/agent-folder/v1/mcp.json`](/schemas/agent-folder/v1/mcp.json)               | An agent manifest's `mcp.json`                                                                 |
| [`/schemas/agent-folder/v1/flow.json`](/schemas/agent-folder/v1/flow.json)             | A `flow.json` file                                                                             |
| [`/schemas/agent-manifest/v8.4.json`](/schemas/agent-manifest/v8.4.json)               | An agent manifest, or the deprecated three-file format's `agent.manifest.json`                 |
| [`/schemas/harness-manifest/v1.4.json`](/schemas/harness-manifest/v1.4.json)           | The three-file format's `harness.manifest.json`                                                |
| [`/schemas/runtime-manifest/v1.2.json`](/schemas/runtime-manifest/v1.2.json)           | The three-file format's `runtime.manifest.json`, or a folder's `runtime.json`                  |
| [`/schemas/harness-api/v5.4.json`](/schemas/harness-api/v5.4.json)                     | The messages and bodies of [Harness API](/docs/build/harness-api) 5, for a harness of your own |

See [Agent manifests](/docs/build/agent-manifests#editor-schemas) and
[Saving manifests](/docs/run/agent-manifests#three-files).

This MCP server only lists, searches, and reads published Guides. It cannot
execute Nylorun APIs. To declare outbound MCP servers an agent can use, see
[MCP](/docs/build/mcp).
