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

# MCP walkthrough

> Connect an LLM client to Nuon and run your first queries.

## Prerequisites

* [Nuon CLI](/cli) installed and authenticated (`nuon auth login`, `nuon orgs select`)
* An LLM client that supports MCP (Cursor, Claude Code, etc.)

## Steps

<Steps>
  <Step title="Register the MCP server">
    Add the stdio proxy. Token and org stay in `~/.nuon`.

    <CodeGroup>
      ```bash Claude Code theme={null}
      claude mcp add --transport stdio nuon -- nuon agents mcp --allow-writes
      ```

      ```bash Amp theme={null}
      amp mcp add nuon -- nuon agents mcp --allow-writes
      ```

      ```json Cursor theme={null}
      {
        "mcpServers": {
          "nuon": {
            "command": "nuon",
            "args": ["agents", "mcp", "--allow-writes"]
          }
        }
      }
      ```
    </CodeGroup>

    Cursor has no `mcp add`. Save the JSON as `~/.cursor/mcp.json` or project `.cursor/mcp.json`, then `agent mcp enable nuon`.

    Examples include `--allow-writes` so mutating tools are available. Your token must have create permission.

    The proxy derives its URL from the configured API hostname (`api.<hostname>` becomes `mcp.<hostname>/mcp`). Override it with `--url` (and `--name` for the client's MCP list) on the registered command. Full examples: [Connect](/guides/agents/overview#connect) and [Override the server](/guides/agents/overview#override-the-server).
  </Step>

  <Step title="Verify context">
    ```bash theme={null}
    nuon agents context
    ```

    Confirm you are authenticated and an org is selected. If not, run `nuon auth login` and `nuon orgs select`.
  </Step>

  <Step title="Ask a first question">
    In the LLM client, paste:

    ```
    Who am I, and what installs are in this org?
    ```

    The client should call `whoami` and `list_installs`. You do not need `select_org` when using the stdio proxy (org is already in `X-Nuon-Org-ID`).

    More prompts: [Sample queries](/guides/agents/sample-queries).
  </Step>
</Steps>

Tool catalog: [Tools](/guides/agents/tools). Prompts to paste: [Sample queries](/guides/agents/sample-queries).