The UserLoop MCP server lets AI agents like Claude Desktop and ChatGPT access your survey data through the [Model Context Protocol](https://modelcontextprotocol.io/). This means you can ask an AI assistant to analyze your survey responses, check analytics, and pull feedback data — all through natural conversation.

### What You Can Do

The MCP server exposes seven tools that AI agents can use:

| Tool | Description |
|---|---|
| **List Surveys** | Get a list of all your surveys |
| **Get Survey** | Get detailed info about a specific survey |
| **Analytics Counts** | Get aggregated response counts for a survey question |
| **Open Ended Responses** | Get text responses for open-ended questions |
| **Raw Responses** | Get raw survey response data |
| **Get Response** | Get a single response by ID |
| **Health Check** | Verify the connection to UserLoop is working |

For example, you could ask Claude: "Show me the top responses for my checkout survey this month" and it will use the MCP server to fetch and analyze the data for you.

### Connecting to Claude Desktop

**1.** Open Claude Desktop and go to **Settings** > **Developer** > **Edit Config**.

**2.** Add the UserLoop MCP server to your configuration:

```json
{
  "mcpServers": {
    "userloop": {
      "url": "https://mcp.userloop.io/mcp?api_key=YOUR_API_KEY"
    }
  }
}
```

**3.** Replace `YOUR_API_KEY` with your UserLoop API key. You can find this in your UserLoop dashboard under **Account**.

**4.** Restart Claude Desktop. You should see the UserLoop tools available in the tools menu.

### Connecting to ChatGPT

**1.** In ChatGPT, go to **Settings** > **Apps & Connectors** > **Create**.

**2.** Enter the MCP server URL: `https://mcp.userloop.io/mcp`

**3.** Select **No Authentication** and add a custom header:
- **Header name:** `X-UserLoop-Key`
- **Header value:** Your UserLoop API key

**4.** Save the connector. The UserLoop tools will be available in your conversations.

### Authentication

The MCP server needs your UserLoop API key to access your data. You can provide it in three ways:

- **Query parameter** — Append `?api_key=YOUR_KEY` to the MCP server URL (simplest for Claude Desktop)
- **Header** — Send an `X-UserLoop-Key` header with your API key

### Privacy and Email Redaction

By default, the MCP server redacts email addresses in survey responses before sending them to the AI agent. For example, `james@example.com` becomes `ja**@ex*****.com`. This helps protect customer privacy when using third-party AI services.

You can disable redaction by passing `redact_emails: false` when calling the response tools, but we recommend keeping it enabled.

### Need Help?

If you have any questions about the MCP server, reach out to us via live chat and we'll be happy to help.