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

# Install

> Connect an AI agent to Insito with the MCP server — create surveys, read analytics, and browse responses in natural language.

The **Insito MCP server** exposes your Insito workspace to AI agents through the
[Model Context Protocol](https://modelcontextprotocol.io). Point any MCP client
— [Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.com), or
your own — at it, and you can create surveys, publish them, and read NPS
analytics just by asking.

It's published on npm as [`@insito/mcp`](https://www.npmjs.com/package/@insito/mcp)
and runs locally over stdio, so no data leaves your machine except the calls it
makes to the Insito API on your behalf.

## Requirements

| Requirement            | Notes                                             |
| ---------------------- | ------------------------------------------------- |
| Node.js 20+            | Runs the MCP server locally.                      |
| An MCP client          | Claude Desktop, Cursor, or any stdio MCP client.  |
| A **paid Insito plan** | MCP access (API keys) is available on paid plans. |

<Note>
  MCP access is a paid feature. On the free plan the **Settings → API keys**
  screen shows an upgrade prompt instead of the create form, and any existing
  key stops working if a workspace drops back to free. Upgrade under
  **Settings → Plan** in the dashboard.
</Note>

## Get an API key

The MCP server authenticates with a **dashboard API key** — a personal access
token that acts on your workspace with your account's access.

<Steps>
  <Step title="Open the dashboard">
    Go to [admin.insito.app](https://admin.insito.app) and open **Settings → API keys**.
  </Step>

  <Step title="Create a key">
    Click **Create key**, give it a name (e.g. "Claude Desktop"), and copy the
    generated token. It looks like `insk_…`.
  </Step>

  <Step title="Store it safely">
    You'll only see the full key once. Treat it like a password — anyone with it
    can manage your surveys. You can revoke it anytime from the same screen.
  </Step>
</Steps>

<Warning>
  API keys grant full access to your workspace's surveys and responses. Don't
  commit them to source control or paste them into shared chats. Revoke a key
  immediately if it leaks.
</Warning>

## Next step

Head to [Configure](/mcp/configure) to wire the key into your MCP client, then
see the [Tools reference](/mcp/tools) for what you can ask.