MCP Server

The UserLoop MCP server connects Claude, ChatGPT, and other compatible AI clients to your UserLoop survey data through the Model Context Protocol. You can explore feedback, compare answer counts, review NPS, find individual responses, and chart response volume by asking questions in natural language.

All UserLoop MCP tools are read-only. They can retrieve and analyse survey data, but they cannot create, edit, or delete anything in your UserLoop account.

What You Can Ask

Try prompts such as:

• “Chart response volume across all surveys for the last 90 days and break it down by survey.”
• “How did customers answer ‘How did you hear about us?’ this month?”
• “Show the NPS score and promoter, passive, and detractor breakdown for our quarterly survey.”
• “Summarise the main themes in open-text responses from the post-purchase survey.”
• “Compare answer counts, revenue, and average order value for this question.”

Your AI client chooses the appropriate UserLoop tools automatically.

Interactive Charts

Clients that support MCP Apps can display UserLoop results as interactive charts directly in the conversation. Clients without MCP Apps support still receive the same data as compact JSON.

Response Volume Over Time

View response volume for one survey, one question, or every survey combined. Switch between 7 days, 30 days, 90 days, 12 months, or all time, and use automatic, daily, weekly, or monthly grouping. Company-wide results also include a per-survey breakdown and a data-table view.

Answer Counts

Multiple-choice results are shown as a horizontal bar chart with response counts and share. Hover over a result to see more detail, including revenue and average order value when available.

NPS

Number Score and NPS questions include the headline NPS score, average score, promoter/passive/detractor split, 0–10 score distribution, and revenue metrics when available.

The screenshots above use example data. When connected, the charts use your UserLoop survey data.

Available Tools

The server currently provides eight tools:

Before You Connect

Create a UserLoop API key in your UserLoop account. API keys start with ul_live and are shown only once, so create a new one if you no longer have the full key. See UserLoop API for more information.

Your MCP server URL is:

https://mcp.userloop.io/mcp?api_key=ul_live_...

Replace ul_live_... with your complete API key.

Keep this URL private. It contains your UserLoop API key. Do not share it, publish it, or include it in screenshots. Rotate the key immediately if it is exposed.

Connect to Claude or Claude Desktop

Remote MCP connectors are available on supported Claude plans.

1. Open Settings > Connectors in Claude or Claude Desktop.
2. Select Add custom connector.
3. Name the connector UserLoop.
4. Paste the complete MCP server URL, including ?api_key=....
5. Select Add.
6. In a conversation, open Search and tools and enable the UserLoop connector.

Remote servers in Claude Desktop are configured through Settings > Connectors, not claude_desktop_config.json.

See Anthropic’s custom connector guide for current plan and workspace requirements.

Connect to ChatGPT

Custom MCP apps are available to supported ChatGPT workspace plans and may need to be enabled by a workspace administrator.

1. Enable developer mode if your workspace requires it.
2. Open Settings > Apps > Create, or ask a workspace administrator to open Workspace settings > Apps > Create.
3. Enter the complete MCP server URL, including ?api_key=....
4. Choose No authentication if prompted. The UserLoop API key is already included in the URL you entered.
5. Scan the available tools and create the app.
6. Enable UserLoop from the app menu in a conversation.

See OpenAI’s developer mode and MCP apps guide for current availability and administrator controls.

Connect from Another MCP Client

Use the complete URL above with a client that supports remote MCP servers over Streamable HTTP. A typical configuration looks like this:

{
  "mcpServers": {
    "userloop": {
      "type": "http",
      "url": "https://mcp.userloop.io/mcp?api_key=ul_live_..."
    }
  }
}

The exact configuration format depends on your MCP client.

Privacy and Email Redaction

Email redaction is enabled by default for open-text, raw-response, and individual-response tools. For example, [email protected] is returned in a masked form. This helps protect customer privacy when data is sent to a third-party AI service.

The response tools support redact_emails: false, but only disable redaction when you have a clear reason and are comfortable sharing those addresses with your AI provider.

Response-Volume Notes

• Response-volume charts can combine all surveys in a single request and include totals for each survey.
• A response-volume row represents an answer given to a question, rather than a completed survey submission. Use a question filter when you want to count answers to one specific question.
• The server reads up to 2,000 response rows for a time-series request. If a result is marked as truncated, narrow the date range or select a specific survey.

Troubleshooting

The connection or health check fails

• Confirm that the URL includes the complete ?api_key=ul_live_... query parameter.
• The MCP server no longer accepts the old X-UserLoop-Key header method.
• Create a new UserLoop API key if the original key has been revoked, lost, or exposed.

The new time-series tool is missing

Refresh or rescan the connector’s tools. In ChatGPT, newly added tools may need to be enabled by a workspace administrator. If refreshing does not work, remove and re-add the connector using the current URL.

Charts are not displayed

Your client may not support MCP Apps, or it may need to refresh the UserLoop connector. The tool still returns the underlying data, which the AI assistant can analyse and present as text or a table.

Need Help?

If you have questions about the UserLoop MCP server, contact us through live chat and we’ll be happy to help.