Loading ToolBench

Reading the current corpus…

exportcomments-cli MCP server · C · ToolBench

exportcomments-cli

github.com/exportcomments/exportcomments-cli

CLI tool and MCP server for ExportComments.com API - export comments and reviews from 40+ platforms. Optimized for AI agent usage.

2026-07-28+7 tools

69/100

Definition Quality83

Protocol Readiness62

Supportability51

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence · detected: stateful session

Deprecated protocol patterns detected

Summary

Strong tool naming (verb_noun pattern), comprehensive parameter schemas with Zod validation, and detailed descriptions. All 7 tools have clear names and descriptions (avg 150+ chars). Input schemas are well-typed with optional/required distinction. However, output schemas are not documented, responses are JSON-stringified without field-level documentation. Error handling returns JSON but lacks actionable recovery guidance. Missing tool annotations (readOnlyHint/destructiveHint). Parameter descriptions are good but some lack format constraints (e.g., date formats, VPN country codes).

Tools (7)

check_exportread onlyauthsource verified88/100

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. Set wait=true to poll until the job reaches a terminal state.

detect_platformread onlysource verified83/100

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

download_exportread onlyauthsource verified85/100

Download a completed export's data for analysis (status must be "done"). Returns JSON for Premium/Business accounts and CSV for Free/Personal accounts — CSV is plain text, ideal for reading and analyzing the comments directly. The format defaults to the best option for your plan; pass "format" to override (JSON requires a Premium or Business plan).

export_commentswriteauthsource verified90/100

Create a new export job to extract comments or reviews from a URL. Supports 33+ platforms: Instagram, YouTube, TikTok, Facebook, Twitter/X, Reddit, LinkedIn, Trustpilot, Amazon, Yelp, Google Reviews, and more. Returns a job GUID for tracking. Use check_export to monitor progress. Set wait=true to poll until completion (up to 10 minutes).

get_my_profileread onlyauthsource verified78/100

Get the authenticated user's profile information including plan type, API access, and usage statistics.

Issues (5)

HIGHresponse-shaper ↗

Output schemas not documented. Tools return JSON.stringify(result) without field-level documentation. LLMs cannot plan downstream calls or extract specific fields reliably.

export_commentscheck_exportlist_exportsdownload_exportdetect_platformlist_platformsget_my_profile

HIGHrecovery-guide ↗

Error responses lack actionable recovery guidance. Errors return raw JSON without suggesting next steps (e.g., 'Try detect_platform() first' or 'Check your API token').

export_commentscheck_exportdownload_export

MEDIUMtool-annotations ↗

Tool annotations missing. No readOnlyHint, destructiveHint, or idempotentHint declared. LLMs cannot infer which tools are safe to retry or have side effects.

export_commentscheck_exportlist_exportsdownload_exportdetect_platformlist_platformsget_my_profile

Recommendations

Document output schemas for all tools. Define the structure of job objects (guid, status, progress, downloadUrl, error), platform objects (name, urlPattern, supportedOptions), and profile objects (plan, apiUsage). Include field types and descriptions.
Enhance error responses with recovery guidance. E.g., if API token is missing, return 'Missing API token. Get one at https://app.exportcomments.com/user/api or via OAuth at https://exportcomments.com/oauth/authorize.' If job fails, suggest 'Try detect_platform() to verify the URL is supported.'
Add tool annotations via MCP SDK. Mark export_comments and download_export with destructiveHint=true (they create/modify state). Mark read-only tools (check_export, list_exports, detect_platform, list_platforms, get_my_profile) with readOnlyHint=true. Mark idempotent tools (check_export, detect_platform) with idempotentHint=true.
Constrain numeric and enum parameters. Add enum for 'vpn' (or document valid country codes). Add min/max for 'limit' (e.g., 1 - 10000). Add pattern or enum for 'format' in download_export (already has enum, good). Validate dates in export_comments (reject invalid ISO 8601).
Expand list_exports and list_platforms descriptions to 100+ chars. Explain what structure they reveal and when to call them. E.g., 'List all export jobs for the authenticated account with pagination. Call this to track ongoing exports or resume interrupted jobs. Returns job GUID, status, progress, and download URLs.'

Spec posture evidence

Inferred effective spec: 2026-07-28+.

Relies on Stateful initialize / Mcp-Session-Id (removed; protocol is stateless) - make each request self-contained

Score history

Overall score trend

First recorded score · v2 rubric

69/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	C	69	2026-07-28+	v2