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

# MCP Server

> Give Claude, Cursor, or any AI agent access to your SuperPlanner workspace.

Connect **any AI agent** to your SuperPlanner workspace — Claude, Cursor, Windsurf, and more. The setup is the same regardless of which tool you use.

## Prerequisites

* **Node.js 18 or higher**
* A **SuperPlanner API token** — [generate one in SuperPlanner settings](/superplanner/api/generate-token)
* Your **monday.com region** — one of `us`, `eu`, `au`, or `il`

## Setup

The server runs via `npx` — no global install needed. Add the following block to your MCP client's config file:

```json theme={null}
{
  "mcpServers": {
    "SuperPlanner": {
      "command": "npx",
      "args": ["-y", "@spotnik/superplanner-mcp", "--token", "sp_xxx", "--region", "us"]
    }
  }
}
```

Replace `sp_xxx` with your API token and `us` with your region code.

| Flag       | Required | Values                 | Description                          |
| ---------- | -------- | ---------------------- | ------------------------------------ |
| `--token`  | Yes      | `sp_...`               | Your SuperPlanner API token          |
| `--region` | Yes      | `us`, `eu`, `au`, `il` | The region your account is hosted in |

<Tip>
  Not sure which region to use? In monday.com, go to your **avatar** → **Administrator** → **General** → **Profile**. Your region is listed under **"Your Data is stored in"**. You can also start with `us` — the server will automatically redirect if it doesn't match.
</Tip>

### Config file location for common clients

| Client             | Config file                                                                      |
| ------------------ | -------------------------------------------------------------------------------- |
| **Claude Desktop** | `claude_desktop_config.json` — find it via Claude Desktop → Settings → Developer |
| **Cursor**         | `.cursor/mcp.json` in your project root, or the global Cursor MCP config         |
| **Windsurf**       | `~/.codeium/windsurf/mcp_config.json`                                            |

For any other MCP client, refer to its documentation on how to add a server entry using the `command` + `args` format above.

## Related

* [Generate an API token](/superplanner/api/generate-token)
* [API quickstart](/superplanner/api/quickstart)