> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ascendgtm.net/llms.txt
> Use this file to discover all available pages before exploring further.

# llms.txt + MCP from Docs

> Machine-readable docs and the auto-generated MCP server from Mintlify

## llms.txt

Mintlify auto-generates a `llms.txt` file from these docs — a structured, LLM-friendly summary of the entire documentation tree. AI tools use this to understand the V5 Gateway without fetching every page.

```
GET https://docs.ascendgtm.net/llms.txt
```

The file follows the [llms.txt standard](https://llmstxt.org/): one URL per line, with a short description. It's updated on every doc deploy.

### Use cases

* **Seed an AI tool's context** — paste the llms.txt URL into a Claude project or ChatGPT custom instruction to give it gateway knowledge
* **Index for RAG** — embed the docs into your own vector database using the llms.txt as the crawl manifest
* **Cursor Rules** — reference `https://docs.ascendgtm.net/llms.txt` in `.cursorrules` so Cursor always has fresh gateway docs

## MCP server from docs

Mintlify exposes an MCP server generated from these docs:

```
GET https://docs.ascendgtm.net/mcp
```

This MCP server lets AI tools query the V5 documentation via tool calls — without needing to fetch pages manually. Useful for:

* AI tools that need to look up tool schemas before calling them
* Building Q\&A agents over the V5 docs
* Verifying current tool limits and behavior before implementing

### Connect Claude Code to the docs MCP

```bash theme={null}
claude mcp add --transport http ascend-docs https://docs.ascendgtm.net/mcp
```

### Available tools

The Mintlify-generated MCP server typically exposes:

| Tool         | Description                           |
| ------------ | ------------------------------------- |
| `search`     | Full-text search across all doc pages |
| `get_page`   | Retrieve a specific doc page by path  |
| `list_pages` | List all pages in a section           |

<Note>
  The docs MCP is read-only — it queries documentation, not live gateway data. For live GTM data, use the V5 Gateway MCP at `https://ascend-gateway-v5.ascendgtm.workers.dev/mcp`.
</Note>

## Full-text search

Mintlify's built-in search indexes all pages. Use `⌘K` on the docs site, or the search API:

```bash theme={null}
curl "https://docs.ascendgtm.net/api/search?q=google+ads+ROAS"
```

## Keeping docs in sync with code

The docs live at `docs-site/` in `github.com/mishaal-cloud/ascend-gtm-ops`. Mintlify deploys on every push to `main` that touches `docs-site/`. The llms.txt is regenerated on each deploy.

The tool count in `docs/reference/mcp-tools` is validated against the actual count registered in `src/handlers/mcp.ts` by a CI check — so the docs stay accurate as tools are added.