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 30+ tools for AI assistants to create surveys, collect responses, and analyze results.
  • MCP API Endpoints — LLM-optimized REST endpoints that aggregate data into single responses, reducing the number of API calls needed.

MCP Server Setup

Install the MCP server to give your AI assistant direct access to Revuloop:

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

Requires a BUSINESS subscription for API access. 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