VOC Amazon Reviews — Claude Code MCP server: setup & tools
Extracts Amazon or CSV customer reviews, detects buyer pain points, and builds HTML dashboards. Useful for rewriting e-commerce listings based on real feedback.
claude mcp add voc-amazon-reviews-mcp -e VOC_API_KEY=<VOC_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx voc-amazon-reviews-mcpWhat VOC Amazon Reviews does
The server provides six tools to pull and inspect customer feedback. It queries Shulex OpenAPI by ASIN across 10 Amazon marketplaces. If your catalog lives elsewhere, the analyze_csv tool accepts review spreadsheets from Shopify, eBay, or Helium 10 using fuzzy column mapping. Output options include Markdown summaries, raw JSON data, and a standalone black-and-gold HTML deck.
Running the server requires uvx and a valid VOC_API_KEY. Shulex offers a free tier of 100 requests per month without requiring a payment card. The extract_listing_improvements tool calls Claude directly, so it fails without a native ANTHROPIC_API_KEY from Anthropic. Be mindful of execution times on serverless hosts: full analysis can take up to 90 seconds.
What it helps with
- Fetch customer reviews for an Amazon ASIN across 10 marketplaces
- Extract product flaws and user complaints from custom CSV files
- Generate listing bullet points grounded in buyer phrasing
- Render an offline HTML sentiment dashboard without external assets
Example prompts for the agent
- Generate a VOC report for ASIN B08N5WRWNW and export the dashboard to
~/Desktop/voc.html - Analyze customer complaints in
reviews.csvand list recurring defects - Generate 5 listing bullet points for
B08N5WRWNWbased on customer feedback
How to install VOC Amazon Reviews
Platform CLI
claude mcp add voc-amazon-reviews-mcp -e VOC_API_KEY=<VOC_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx voc-amazon-reviews-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>
Platform CLI
codex mcp add voc-amazon-reviews --env VOC_API_KEY=<VOC_API_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx voc-amazon-reviews-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>
Config file
{
"mcpServers": {
"voc-amazon-reviews": {
"command": "uvx",
"args": [
"voc-amazon-reviews-mcp"
],
"env": {
"VOC_API_KEY": "<VOC_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>
Config file
{
"servers": {
"voc-amazon-reviews": {
"type": "stdio",
"command": "uvx",
"args": [
"voc-amazon-reviews-mcp"
],
"env": {
"VOC_API_KEY": "<VOC_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>
Platform CLI
gemini mcp add -e VOC_API_KEY=<VOC_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> voc-amazon-reviews uvx voc-amazon-reviews-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VOC Amazon Reviews
How to install VOC Amazon Reviews in Claude Code?
Run claude mcp add voc-amazon-reviews-mcp -e VOC_API_KEY=<VOC_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx voc-amazon-reviews-mcp.
What does VOC Amazon Reviews do?
It connects your AI agent to Amazon review data via Shulex OpenAPI or processes local CSV exports. The server turns customer feedback into sentiment reports and listing copy suggestions.
Is an Anthropic API key mandatory?
Most tools only require VOC_API_KEY to retrieve and analyze reviews. You only need ANTHROPIC_API_KEY if you invoke extract_listing_improvements, and keys from other providers will not work.
