MCP Server

The CLI includes an MCP (Model Context Protocol) server that gives AI assistants native access to ExportComments tools. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Installation

npm install -g exportcomments-cli

Or use npx for zero-install setup (recommended for MCP clients):

npx -y exportcomments-cli

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "exportcomments": {
      "command": "npx",
      "args": ["-y", "exportcomments-cli"],
      "env": {
        "EXPORTCOMMENTS_API_TOKEN": "your-token-here"
      }
    }
  }
}

Claude Code

claude mcp add exportcomments -- npx -y exportcomments-cli

Then set the environment variable:

export EXPORTCOMMENTS_API_TOKEN="your-token-here"

Cursor

Add to your .cursor/mcp.json in your project root or global settings:

{
  "mcpServers": {
    "exportcomments": {
      "command": "npx",
      "args": ["-y", "exportcomments-cli"],
      "env": {
        "EXPORTCOMMENTS_API_TOKEN": "your-token-here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "exportcomments": {
      "command": "npx",
      "args": ["-y", "exportcomments-cli"],
      "env": {
        "EXPORTCOMMENTS_API_TOKEN": "your-token-here"
      }
    }
  }
}

Run Directly

EXPORTCOMMENTS_API_TOKEN="your-token" exportcomments-mcp

Authentication

Get your API token from the API dashboard. The MCP server reads it from the EXPORTCOMMENTS_API_TOKEN environment variable.

Available Tools

The MCP server exposes 6 tools to AI assistants:

Tool Parameters

export_comments

Create a new export job to extract comments or reviews from a URL. Supports 33+ platforms including Instagram, YouTube, TikTok, Facebook, Twitter/X, Reddit, Amazon, Trustpilot, and more. Returns a job GUID for tracking.

check_export

Check the status of an export job by its GUID. Returns full job details including status, progress, download URLs, and error info. Job statuses: queueing → progress → done | error.

list_exports

List all export jobs for the authenticated account with pagination.

download_export

Download the raw JSON data for a completed export job. Returns the actual exported comments/reviews as structured JSON data. The job must have status done.

detect_platform

Detect which platform a URL belongs to and return supported options. Use this before export_comments to understand what options are available for a URL.

list_platforms

List all 33+ supported platforms with their URL patterns, export options, and example URLs. No parameters required.

Example Workflows

Export and download comments

An AI agent can chain tools together for a complete workflow:

1. detect_platform — check what options the URL supports
2. export_comments with wait=true — create the export and wait for completion
3. download_export — retrieve the raw JSON data

Monitor an existing job

1. check_export with wait=true — wait until the job finishes
2. download_export — get the results

Discover platforms

1. list_platforms — see all supported platforms and their URL patterns
2. detect_platform — verify a specific URL is supported before exporting

Response Format

All MCP tool responses return structured JSON:

{
  "ok": true,
  "data": {
    "id": 12345,
    "guid": "b4219d47-3138-5efd-9762-2ef9f9495084",
    "status": "done",
    "url": "https://www.instagram.com/p/ABC123/",
    "totalComments": 342,
    "exportedComments": 342,
    "downloadUrl": "https://exportcomments.com/api/v3/job/b4219d47-.../download"
  }
}

On error:

{
  "ok": false,
  "error": "Human-readable error message",
  "error_code": "MACHINE_READABLE_CODE",
  "detail": "Additional context"
}