Shopper Approved MCP by usefulapi

Read seller and product reviews and rating statistics in Shopper Approved.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
86%
Naming quality
66%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (5)

  • LOWTool 'shopperapproved_list_product_reviews' name length outside 3-30 rangein shopperapproved_list_product_reviews
  • LOWTool 'shopperapproved_get_product_reviews' name length outside 3-30 rangein shopperapproved_get_product_reviews
  • LOWTool 'shopperapproved_get_review_stats' name length outside 3-30 rangein shopperapproved_get_review_stats
  • LOWTool 'shopperapproved_get_product_stats' name length outside 3-30 rangein shopperapproved_get_product_stats
  • LOWTool 'shopperapproved_get_product_stat' name length outside 3-30 rangein shopperapproved_get_product_stat

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,511Tokens (tool definitions)
~1.6 KBTypical response size
Moderate attention impact (1.18% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "shopper-approved": {
      "url": "https://shopper-approved.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://shopper-approved.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢shopperapproved_list_reviews(from, to, rating, sort, limit, ...)

List the store's seller (service) reviews: review ID, date, reviewer name, rating, comment and media. Results are for the customer's own use. Shopper Approved API: GET /reviews/{siteid}.

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Start date, yyyy-mm-dd. If you leave it out, the API returns only the last 30 days. Use an old date (for example 2010-01-01) for all reviews.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "rating": {
      "description": "Comma list of ratings to keep, for example 1,2,3.",
      "type": "string",
      "pattern": "^[1-5](,[1-5])*$"
    },
    "sort": {
      "description": "Sort order by date.",
      "type": "string",
      "enum": [
        "oldest",
        "newest"
      ]
    },
    "limit": {
      "description": "Reviews per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000
    },
    "page": {
      "description": "Page number, counted from 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "removed": {
      "description": "Set to 1 to include removed reviews.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    },
    "full_name": {
      "description": "Set to 1 to return the full reviewer name.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shopperapproved_get_review(order_id, removed, full_name)

Get one seller review by the order ID that was sent with the order. Shopper Approved API: GET /reviews/{siteid}/{reviewid}.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The order ID of the review."
    },
    "removed": {
      "description": "Set to 1 to include removed reviews.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    },
    "full_name": {
      "description": "Set to 1 to return the full reviewer name.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shopperapproved_list_product_reviews(from, to, sort, limit, page, ...)

List product reviews for the whole store, newest data by date range. Shopper Approved API: GET /products/reviews/{siteid}.

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Start date, yyyy-mm-dd. If you leave it out, the API returns only the last 30 days. Use an old date (for example 2010-01-01) for all reviews.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "sort": {
      "description": "Sort order by date.",
      "type": "string",
      "enum": [
        "oldest",
        "newest"
      ]
    },
    "limit": {
      "description": "Reviews per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000
    },
    "page": {
      "description": "Page number, counted from 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "removed": {
      "description": "Set to 1 to include removed reviews.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shopperapproved_get_product_reviews(product_id, from, to, sort, limit, ...)

Get the reviews of one product. A parent ID returns the reviews of all products with that parent ID. Shopper Approved API: GET /products/reviews/{siteid}/{productid}.

Input Schema

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Product ID or parent ID, as sent in your product feed to Shopper Approved."
    },
    "from": {
      "description": "Start date, yyyy-mm-dd. If you leave it out, the API returns only the last 30 days. Use an old date (for example 2010-01-01) for all reviews.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "sort": {
      "description": "Sort order by date.",
      "type": "string",
      "enum": [
        "oldest",
        "newest"
      ]
    },
    "limit": {
      "description": "Reviews per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000
    },
    "page": {
      "description": "Page number, counted from 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "removed": {
      "description": "Set to 1 to include removed reviews.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shopperapproved_get_review_stats

Get the aggregate statistics of the store's seller reviews (totals and average rating). Shopper Approved API: GET /aggregates/reviews/{siteid}.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shopperapproved_get_product_stats(by_match_key, site_only)

Get the total number of product reviews, and the review count and rating of each product. Shopper Approved API: GET /aggregates/products/{siteid}.

Input Schema

{
  "type": "object",
  "properties": {
    "by_match_key": {
      "description": "Group the numbers by group ID.",
      "type": "boolean"
    },
    "site_only": {
      "description": "Return the site totals only.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shopperapproved_get_product_stat(product_id)

Get the review count and rating of one product. Shopper Approved API: GET /aggregates/products/{siteid}/{productid}.

Input Schema

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric product ID."
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools