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

# Cursor and MCP setup

> Connect Mintlify MCP servers in Cursor to write and search documentation with AI.

Use MCP so Cursor can **search Mintlify component docs**, **edit your Mintlify site**, and (after deploy) **search your published documentation**.

## MCP servers to add

| Server                     | URL                                       | Purpose                                                            |
| -------------------------- | ----------------------------------------- | ------------------------------------------------------------------ |
| **Mintlify Admin MCP**     | `https://mcp.mintlify.com`                | Create/edit pages, update `docs.json`, open PRs (OAuth login)      |
| **Mintlify platform docs** | `https://mintlify.com/docs/mcp`           | Look up Mintlify components and configuration while writing        |
| **Your published docs**    | `https://YOUR-SUBDOMAIN.mintlify.app/mcp` | Search your live Student Label System docs (after Mintlify deploy) |

## Project config (already in this repo)

This repository includes `.cursor/mcp.json` with the Admin and platform MCP servers preconfigured. Open the project in Cursor and complete OAuth when prompted for **mintlify** (Admin MCP).

## Manual setup in Cursor

<Steps>
  <Step title="Open MCP settings">
    Press **Cmd+Shift+P** (Ctrl+Shift+P on Windows) → **Open MCP settings** → **Add custom MCP**.
  </Step>

  <Step title="Add servers">
    Merge the entries from `.cursor/mcp.json` in this project, or paste:

    ```json theme={null}
    {
      "mcpServers": {
        "mintlify": {
          "url": "https://mcp.mintlify.com"
        },
        "mintlify-platform": {
          "url": "https://mintlify.com/docs/mcp"
        },
        "student-label-docs": {
          "url": "https://YOUR-SUBDOMAIN.mintlify.app/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Authenticate Admin MCP">
    Reload Cursor and sign in when **mintlify** (Admin MCP) requests OAuth. This scopes write access to your Mintlify project.
  </Step>

  <Step title="Install the Mintlify skill">
    From the repo root:

    ```bash theme={null}
    npm run docs:skill
    ```

    This installs Mintlify writing guidance for Cursor (components, `docs.json`, tone).
  </Step>

  <Step title="Test">
    Ask Cursor: *"What MCP tools do you have?"* — you should see Mintlify servers listed.
  </Step>
</Steps>

## Example prompts for documentation

* *"Add a new Mintlify page under Storage explaining the 7-year retention policy."*
* *"Update docs.json to add a Troubleshooting group with a page for printer issues."*
* *"Search our published docs MCP for how archive box PDFs work and summarize for staff."*

## References

* [Mintlify Admin MCP](https://www.mintlify.com/docs/ai/mintlify-mcp)
* [Mintlify search MCP](https://www.mintlify.com/docs/ai/model-context-protocol)
* [Cursor + Mintlify guide](https://www.mintlify.com/docs/guides/cursor)