Articles on: Developer Documentation

MCP Server

The UserLoop MCP server lets AI agents like Claude Desktop and ChatGPT access your survey data through the Model Context Protocol. 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:

{
  "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.

Updated on: 26/02/2026

Was this article helpful?

Thank you!