VOC Amazon Reviews

v0.1.1Analyticsstable

Agent-native Amazon review intelligence — fetches verified reviews from 10 marketplaces via real Shulex OpenAPI (not scrapers) and produces copy-ready listing improvements grounded in actual customer language. Backed by a 2B-review historical dataset

amazonamazon-fbaamazon-seller-toolsecommercehelium10-alternative
Share:
20
Stars
0
Downloads
0
Weekly
0/5

What is VOC Amazon Reviews?

VOC Amazon Reviews is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent-native amazon review intelligence — fetches verified reviews from 10 marketplaces via real shulex openapi (not scrapers) and produces copy-ready listing improvements grounded in actual customer ...

Agent-native Amazon review intelligence — fetches verified reviews from 10 marketplaces via real Shulex OpenAPI (not scrapers) and produces copy-ready listing improvements grounded in actual customer language. Backed by a 2B-review historical dataset

This server falls under the Analytics and Marketing & SEO categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Agent-native Amazon review intelligence — fetches verified r

Use Cases

Agent-native Amazon review intelligence — fetches verified reviews from 10 marke
mguozhen

Maintainer

LicenseMIT License
Languagepython
Versionv0.1.1
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

PIP

pip install voc-amazon-reviews-mcp

Manual Installation

pip install voc-amazon-reviews-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use VOC Amazon Reviews

VOC Amazon Reviews MCP is a Python MCP server that provides agent-native Amazon review intelligence by fetching verified reviews from 10 Amazon marketplaces via the Shulex VOC OpenAPI — not scrapers — and producing structured analysis, copy-ready listing improvements, and standalone HTML dashboards. It exposes six tools: fetch_reviews, analyze_reviews, voc_full (combined fetch and analysis), extract_listing_improvements (generates title, 5 bullet points, and description grounded in real customer language), analyze_csv (for non-Amazon review files), and render_dashboard (produces a black-gold HTML report). It is backed by a dataset of 2 billion historical reviews and supports up to 1,000 reviews per ASIN across US, CA, MX, GB, DE, FR, IT, ES, JP, and AU markets.

Prerequisites

  • A Shulex VOC API key (100 free calls/month, no credit card required at apps.voc.ai/openapi)
  • uv or uvx installed for running the server (pip install voc-amazon-reviews-mcp also works)
  • Optional: an Anthropic API key if you want extract_listing_improvements (the only tool that calls Claude directly)
  • An MCP-compatible client such as Claude Code, Cursor, Cline, or Claude Desktop
1

Get your Shulex VOC API key

Sign up at apps.voc.ai/openapi to get a free Shulex API key. The free tier gives 100 API calls per month with no credit card required.

2

Install the package

Install the MCP server via pip or use uvx to run it without a permanent install. uvx is the recommended approach.

pip install voc-amazon-reviews-mcp
# or run directly with uvx (no install needed):
uvx voc-amazon-reviews-mcp
3

Add the server to your MCP client config

Register the server in your MCP client configuration, providing your VOC API key. Optionally add your Anthropic API key to enable listing improvement generation.

4

Run a full VOC analysis on an ASIN

Ask your AI agent to run voc_full on an ASIN. This fetches up to 1,000 reviews and produces a complete voice-of-customer analysis in one call.

5

Generate an HTML dashboard

After running voc_full, ask the agent to call render_dashboard to produce a standalone HTML file with sentiment breakdowns, pain points, and listing suggestions.

VOC Amazon Reviews Examples

Client configuration

Add this to your MCP client config. Replace the API key values with your real credentials.

{
  "mcpServers": {
    "voc-amazon-reviews": {
      "command": "uvx",
      "args": ["voc-amazon-reviews-mcp"],
      "env": {
        "VOC_API_KEY": "your-shulex-api-key",
        "ANTHROPIC_API_KEY": "sk-ant-your-key-here"
      }
    }
  }
}

Prompts to try

Ask your AI agent to analyze Amazon reviews and generate actionable listing improvements.

- "Run a VOC report on ASIN B08N5WRWNW and summarize the top customer complaints."
- "Fetch the reviews for B07XJ8C8F7 from the US marketplace and analyze sentiment."
- "Generate copy-ready listing improvements for ASIN B09G9FPHY6 grounded in real customer language."
- "Render an HTML dashboard for the VOC report and save it to ~/Desktop/review-report.html."
- "Analyze this CSV of eBay reviews and identify the top 5 pain points: /path/to/reviews.csv"

Troubleshooting VOC Amazon Reviews

fetch_reviews returns an authorization error

Your VOC_API_KEY is missing or incorrect. Verify it is set in the env block of your MCP config. Get or regenerate your key at apps.voc.ai/openapi.

extract_listing_improvements fails with an API error

This tool makes direct calls to Claude via the Anthropic API. You must provide a valid ANTHROPIC_API_KEY in your env config. Other AI provider keys (OpenAI, etc.) are not supported by this tool.

voc_full times out on large ASINs

Fetching 1,000 reviews can take 30-90 seconds. If you are running in a serverless environment (Vercel, etc.) with short timeouts, reduce the limit parameter. For production use, run the server locally or on a persistent host like Render or Fly.io.

Frequently Asked Questions about VOC Amazon Reviews

What is VOC Amazon Reviews?

VOC Amazon Reviews is a Model Context Protocol (MCP) server that agent-native amazon review intelligence — fetches verified reviews from 10 marketplaces via real shulex openapi (not scrapers) and produces copy-ready listing improvements grounded in actual customer language. backed by a 2b-review historical dataset It connects AI assistants to external tools and data sources through a standardized interface.

How do I install VOC Amazon Reviews?

Install via pip with: pip install voc-amazon-reviews-mcp. Then configure your AI client to connect to this MCP server.

Which AI clients work with VOC Amazon Reviews?

VOC Amazon Reviews works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is VOC Amazon Reviews free to use?

Yes, VOC Amazon Reviews is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Analytics MCP Servers

Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "voc-amazon-reviews": { "command": "pip", "args": ["install", "voc-amazon-reviews-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use VOC Amazon Reviews?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides