---
title: Agent-readable surfaces
eyebrow: Setting up
description: Plain-text and JSON endpoints an agent can fetch to learn what Nolgia offers and how to call it.
---

# Agent-readable surfaces

Give your agent the docs index, API contract or model catalog so it can look up the request it needs. The documentation and pricing surfaces are public; model capabilities require your token.

## What to fetch

| Surface | What it gives your agent |
| --- | --- |
| [llms.txt](https://docs.nolgia.ai/llms.txt) | A short index of the guides and reference. |
| [llms-full.txt](https://docs.nolgia.ai/llms-full.txt) | All manifest guides as one text file. |
| [Landing Markdown](https://docs.nolgia.ai/index.md) and [guide Markdown](https://docs.nolgia.ai/guides/getting-started.md) | Every guide has a /guides/\<slug\>.md mirror; the landing is /index.md. Use each page's Markdown link. |
| [OpenAPI spec](https://docs.nolgia.ai/api/openapi.yaml) | Paths, request and response schemas, and authentication. |
| [MCP tools](https://docs.nolgia.ai/mcp/tools.json) | The server's tool catalog and input schemas. |
| [Model pricing](https://api.nolgia.ai/v1/pricing/models) | Public prices without a token. |
| `GET /models` | Model capabilities, with a bearer token. |
| CLI `--json` | Machine-readable command output. |
| [Agent installation runbook](https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/INSTALL_FOR_AGENTS.md) | CLI installation, authentication, skills and verification. |

## Fetch the index

```bash
$ curl -fsSL https://docs.nolgia.ai/llms.txt
```

## Read public prices

```bash
$ curl -fsSL https://api.nolgia.ai/v1/pricing/models
```

## Read model capabilities

```bash
$ curl -fsSL https://api.nolgia.ai/v1/models \
  -H "Authorization: Bearer $NOLGIA_TOKEN"
```

:::cards
- [Run MCP](./mcp.html) icon=spot-agent: Connect your agent to the tools.
- [Nolgia for Claude Code, Cursor and Codex](./coding-agents.html) icon=spot-terminal: Install the CLI and skills from your conversation.
- [Libraries, APIs and community](./client-libraries.html) icon=spot-library: Find a client, the API contract and support.
:::