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

# Cursor

> Add the NexSpace MCP server to Cursor IDE

# Cursor Integration

Connect NexSpace as an MCP server in Cursor to access all 16 workforce
management tools from the IDE.

## Setup

Add to your project's `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "nexspace": {
      "url": "https://mcp.nexspace365.com/mcp",
      "env": {
        "NEXSPACE_API_KEY": "nex_live_YOUR_KEY"
      }
    }
  }
}
```

Or add globally at `~/.cursor/mcp.json`.

## Get an API Key

1. Log in to [NexSpace](https://app.nexspace365.com)
2. Go to **Settings → API Keys**
3. Create a key with the scopes you need
4. Paste it as `NEXSPACE_API_KEY`

## Usage

Once configured, Cursor discovers all 16 NexSpace tools automatically.
Ask the agent naturally:

> "Search for available staff at facility 12 for tomorrow"

> "Show me the coverage report for all facilities this week"

> "Verify credential #456 and tell me if it's still valid"

## Agent skill (recommended)

Prefer the CLI skill installer — it drops the `nexspace-operations` skill so
Cursor follows the canonical loop (`search` → `schema` → `--dry-run` → execute)
and compliance walls:

```bash theme={null}
npm install -g @nexspace/cli
nexspace login
nexspace skill install --cursor --project   # or omit --project for user-global
```

## Cursor Rules (legacy)

You can still copy the older rule file if you are not using the skill yet:

```bash theme={null}
cp tools/cursor-mcp/nexspace.mdc .cursor/rules/nexspace.mdc
```

## Available on cursor.directory

Search for "NexSpace" on [cursor.directory](https://cursor.directory) for
one-click installation.