revuloop
Back to developer portal

MCP Integration

Connect AI assistants like Claude Desktop, Cursor, Windsurf, and n8n to your Revuloop surveys using the Model Context Protocol (MCP).

Overview

Revuloop provides two ways to integrate with AI assistants:

  • MCP Server Package : An npm package (@revuloop/mcp-server) that exposes 60 tools for AI assistants to create surveys, collect responses, and analyze results. Also available as a hosted server, with no install required.
  • MCP API Endpoints : LLM-optimized REST endpoints that aggregate data into single responses, reducing the number of API calls needed.

MCP Server Setup

The quickest route is the hosted server. Add this URL as a connector in Claude, Cursor or Windsurf, sign in to Revuloop when prompted, and approve the connection. Nothing to install and no API key involved:

https://revuloop.com/api/mcp

Available on every plan, including Free. Which tools your assistant is offered depends on your plan, and the API enforces the same limits on every call.

To run the server locally instead, use the npm package with a Revuloop API key:

// Claude Desktop config
{
  "mcpServers": {
    "revuloop": {
      "command": "npx",
      "args": ["@revuloop/mcp-server"],
      "env": {
        "REVULOOP_API_KEY": "rlk_live_your_key_here"
      }
    }
  }
}

API keys are available on Starter and up. On Free, use the hosted connector above. See the npm package docs for Cursor, Windsurf, n8n, and Claude Code setup.

MCP API Endpoints

These endpoints return data optimized for LLM consumption: aggregated, formatted, and designed for single-call retrieval. They use standard rlk_ API key authentication.

GET/api/v1/mcp/dashboard

Returns all surveys with response counts, completion rates, trends, alerts, and recent activity. Replaces multiple analytics calls.

Scope: surveys:read

GET/api/v1/mcp/surveys/:id/summary

Comprehensive survey summary with performance metrics, per-question statistics, and health assessment.

Scope: surveys:read

GET/api/v1/mcp/surveys/:id/insights

Deep analytical insights including executive summary, key findings, segments, patterns, and recommendations.

Scope: analytics:read

GET/api/v1/mcp/surveys/:id/responses/recent

Returns the most recent responses (default: 10, max: 25) formatted for AI assistant consumption.

Scope: responses:read | Query: ?limit=10

Available MCP Tools

The MCP server package provides 30+ tools organized by category:

Surveys (9 tools)

List, create, generate from prompts, get, update, launch, pause, close, and delete surveys.

Responses (5 tools)

List, get, submit, export (JSON/CSV/Excel), and delete responses.

Analytics (5 tools)

Get quantitative analytics, overview, AI analytics, generate deep analysis, and poll job status.

Smart Surveys (6 tools)

Create sessions, respond to questions, complete sessions, get analytics, and browse transcripts.

Webhooks (5 tools)

List, create, update, test, and delete webhook subscriptions.

Smart SurveysPartner API