MCP Tool Reference

All 23 tools exposed by mcp.exportcomments.com and the local exportcomments-mcp stdio server. Tools work identically across both transports.

For setup instructions and the OAuth flow, see the MCP Server overview.

Exports

export_comments

Create a new export job. Supports 33+ platforms (Instagram, YouTube, TikTok, Facebook, Twitter/X, Reddit, Trustpilot, Amazon, etc.). Returns a job GUID for tracking. Use wait=true to poll until completion in a single call (up to 10 minutes).

check_export

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

list_exports

List the authenticated account's export jobs with pagination.

download_export

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

Discovery

detect_platform

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

list_platforms

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

Account

get_my_profile

Authenticated account profile: email, plan tier, account ID, registration date. No parameters.

get_my_quota

Current usage vs. allowance: requests today / this month, comments exported, concurrent exports in flight. No parameters.

get_my_limits

Plan tier limits (Premium / Business): daily request cap, rate limit, concurrent exports, max comments per export, webhook count. No parameters.

Random Comment Picker (Giveaways)

pick_random_winners

Pick N random winners from a completed export. Downloads the export's JSON payload, optionally filters by @-mention, #hashtag, or substring, dedupes by commenter username, then picks N uniformly using a Fisher-Yates shuffle.

Returns the winner list with usernames, comment text, and permalinks — suitable for FTC-compliant public verification.

Webhooks

list_webhooks

List the account's webhook subscriptions: event, URL, enabled state, last delivery status. No parameters.

create_webhook

Subscribe a URL to a webhook event. Valid events: export.created, export.finished, export.failed, export.requeued. The URL receives POSTs with a JSON body (signed via X-Webhook-Signature for verification — see webhooks docs).

update_webhook

Change the event or target URL of an existing webhook.

delete_webhook

Permanently remove a webhook subscription. Use toggle_webhook to disable without deleting.

toggle_webhook

Enable or disable a webhook (30-second cooldown between toggles).

test_webhook

Fire a test event at the configured URL to verify delivery. Returns the receiving server's response.

Scheduled Exports

list_schedules

List scheduled (recurring) export jobs for this account. No parameters.

create_schedule

Create a recurring export. Pass either a cron expression or a friendly frequency. options accepts the same fields as export_comments (replies, limit, vpn, cookies, etc.).

At least one of cron or frequency is required.

update_schedule

Edit an existing schedule's URL, cron, frequency, or options.

delete_schedule

Permanently remove a scheduled export. Use pause_schedule to suspend without deleting.

run_schedule

Trigger a scheduled export to run immediately (in addition to its normal cadence).

pause_schedule

Suspend a scheduled export. No new runs until resume_schedule is called.

resume_schedule

Resume a paused scheduled export.

Response format

Every tool returns a structured JSON envelope:

{
  "ok": true,
  "data": { /* tool-specific payload */ }
}

Errors:

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