Documentation
What ZonRival does
ZonRival is a remote MCP (Model Context Protocol) server. Once connected, your AI assistant can look up Amazon listings, keyword rankings and customer complaints, audit listings, compare listing copy, and read Shopify catalogs, then explain what it found. Everything is read-only: ZonRival never changes anything on Amazon, Shopify or your accounts.
Server URL: https://zonrival.com/mcp
Connect
Claude (claude.ai, desktop and mobile). Customize → Connectors → Add custom connector → paste https://zonrival.com/mcp → Connect. Sign in with your email (we send a 6-digit code) or an API key, then click Allow. New accounts get 25 free credits.
ChatGPT. Settings → Connectors → turn on developer mode → Create → paste the same URL and sign in the same way.
Claude Code, Cursor, Windsurf and other MCP clients. Sign in at zonrival.com/account to get an API key and a ready-made snippet for your app. Clients send the key as Authorization: Bearer YOUR_API_KEY.
To disconnect an app, use Connected apps on your account page. Signing in again on the website issues a new API key and turns off the old one.
Tools
| Tool | What it returns | Credits |
|---|---|---|
amazon_product | Title, bullets, description, price, rating, review count, star breakdown, images, video, A+ content, best-seller ranks, "bought in past month". Adds a history summary once ZonRival has seen the product on two different days. | 1 |
amazon_search | Organic results for a keyword in rank order (ads excluded) with price, rating and reviews, plus the products seen advertising on the page. | 1 |
amazon_listing_audit | A 0–100 score for a listing against best practice (title, bullets, images, video, A+, rating, review volume) with specific fixes. | 1 |
amazon_review_complaints | Amazon's "Customers say" summary of all reviews: topics marked negative, mixed or positive with mention counts and quotes, complaints first. Plus the star breakdown and themes from the featured 1–3★ reviews. | 2 |
amazon_keyword_gap | Words and phrases up to 5 competitors use in their titles and bullets that your listing doesn't. This compares listing text; it isn't search-volume data. | 1 per listing |
shopify_store_catalog | A Shopify store's public catalog: product count, price range and median, products on sale, sold-out items, top product types and tags, newest launches. | 2 |
credits_balance | Your remaining credits and what each tool costs. | Free |
Every tool is read-only. If a call fails (for example the ASIN doesn't exist, or there's nothing to analyze), its credits are refunded automatically.
Example prompts
- "Audit Amazon listing B07H9PZDQW and tell me the three fixes that matter most."
- "What do customers complain about on B0C3JBKSR7 in the UK? What could a competitor do better?"
- "Who ranks organically for 'dog harness' on Amazon UK, and who's advertising?"
- "Compare my listing B0XXXXXXXX with B0YYYYYYYY and B0ZZZZZZZZ. What words am I missing?"
- "Pull gymshark.com's catalog: price range, what's on sale and what launched recently."
Marketplaces
Use the marketplace argument (default us): us, uk, de, fr, it, es, ca, in, jp, au, mx, ae. Your assistant usually picks it from your question ("…in Germany").
Data sources and limits
- Amazon data comes from Amazon's public product and search pages (no Amazon login), collected through a data provider, and is refreshed at most every few hours.
- Amazon shows signed-out visitors only a few featured reviews, so complaint analysis leads with Amazon's "Customers say" summary, which Amazon builds from all reviews. New listings with few reviews may not have one.
- Amazon doesn't show every ad to automated requests, so the advertising list in search results can be incomplete.
- When ZonRival can't detect A+ content, the audit says so and leaves it out of the score rather than guessing.
- Shopify data comes from the store's public catalog; stores that disable it can't be read.
Credits and billing
Tools use credits (see the table). Plans: Starter $29/month (600 credits), Pro $79/month (2,000 credits), or a one-time $19 top-up (400 credits). Unused credits roll over and never expire. Payments, invoices and cancellations are handled by Dodo Payments; manage them from your account page. See the Terms for refunds.
Privacy and security
We store your email, credit balance, recent tool usage (tool name and the ASIN, keyword or store looked up) and billing records. We don't receive or store your conversations with your AI assistant. Details are in the Privacy Policy. You can download or delete your data from your account page.
Support
Email support@zonrival.com.