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

# LLM Docs

> Reading order, MCP URL, llms.txt, and integration rules.

This site (`docs.neus.network`) is the standard integration reference. Follow the order below so fields, tools, and billing context stay consistent.

## Read first

1. [Choose a path](../get-started) — pick app, assistant, agent, or backend
2. [Quickstart](../quickstart) (apps) or [Install](../install) (assistants)
3. [Trust stack](../platform/trust-stack) — loop and architecture
4. [MCP tools](../mcp/tools) or [API overview](../api/overview) as needed

## MCP for assistants

**Product server:** `https://mcp.neus.network/mcp` — identity, proofs, delegation, verify.\
**Not the product:** `https://docs.neus.network/mcp` — documentation search only (Mintlify).

1. Install: [Install NEUS](../install) — `neus setup` → `neus check`
2. Session flow: [MCP overview](../mcp/overview) — reuse receipts before new verification
3. Example prompts: [MCP journeys](../mcp/journeys)

Use **`neus auth`** for OAuth. Profile access keys (`npk_*`) are for servers and CI only.

## Rules

* **Browser → NEUS:** SDK (`NeusClient`, widgets) or **Hosted Verify**. Do not call `api.neus.network` from the browser with secrets or ad-hoc headers; use a **server proxy** when you need custom server-side calls.
* **Server → NEUS:** `gateCheck`, eligibility, secrets, raw HTTP — [API overview](../api/overview)
* Account, gates, and billing: [Choose a path](../get-started)
* Default hosted sign-in: [Hosted Verify](../cookbook/auth-hosted-verify). Optional in-app signing: [Signing format](../verification/signing-format)
* Do not use wallet **private keys** as MCP credentials. Sign in with **OAuth** or use **Profile access keys** (`npk_*`) for Bearer in MCP or server config only.
* **402:** use the x402 retry pattern
* Agents: [Overview](../agents/overview) · [Agent setup](../agents/agent-verification-flow) · [Discover agents](../agents/named-agent-card)
* Use returned receipt URLs or qHashes only when the API/tool response provides them.

## Exports

```bash theme={"dark"}
# Plain text summary (same content as https://neus.network/llms.txt)
curl https://neus.network/llms.txt
```

## MCP JSON

**Cursor** uses a URL-only entry inside `mcpServers` and discovers OAuth from the server's 401 challenge:

```json theme={"dark"}
{
  "mcpServers": {
    "neus": {
      "url": "https://mcp.neus.network/mcp"
    }
  }
}
```

**VS Code, Claude Desktop, and other spec-compliant hosts** use `type: "http"`:

```json theme={"dark"}
{
  "mcpServers": {
    "neus": {
      "type": "http",
      "url": "https://mcp.neus.network/mcp"
    }
  }
}
```

Jump to [MCP overview](../mcp/overview), [MCP setup](../mcp/setup), or the [HTTP API](../api/overview) when you need detail beyond this reading order.