# com.asinrating/asinrating

> Read-only Amazon shopping intelligence: Top-100 BSR, product profiles, price history, comparisons.

- name: com.asinrating/asinrating
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 81/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.asinrating%2Fasinrating
- tools: https://api.protogrid.dev/v1/servers/com.asinrating%2Fasinrating/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "asinrating": {
      "type": "http",
      "url": "https://asinrating.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-3d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 81/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 11 of 11 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_sub_category_brief (destructiveHint, openWorldHint); get_product (destructiveHint, openWorldHint); compare_products (destructiveHint, openWorldHint); …
- pass `tools.token_cost`: about 1,960 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 3 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 11, about 1,960 tokens to load them all
- tool set hash: 277afba9bed031cbb21a95353b84b4e2
- tools last changed: 2026-11-06T13:08:17.662Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.asinrating/asinrating.svg)](https://protogrid.dev/servers/com.asinrating/asinrating)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-06 `request` changed (description)
  - before: Fetch structured data by URL or ASIN with optional field filters. Pass either url (an Amazon product page URL) or asin (10-char alphanumeric). fields (optional enum): profile | price | trend | ratings | competitiveness | seller | facts_check | red_flags | sentiment | data_limitations. live (optional, default false): when true, additionally hits a live data endpoint (~15-30s) and appends a "live" block with the freshest price, stock, Buy Box seller, rating, and review count, plus data_as_of and is_stale flags. Unknown field values return an error with the full list of allowed fields.
  - after: Fetch structured data by URL or ASIN with optional field filters. Pass either url (an Amazon product page URL) or asin (10-char alphanumeric). fields (optional enum): profile | price | trend | ratings | competitiveness | seller | facts_check | product_features | red_flags | sentiment | data_limitations. live (optional, default false): when true, additionally hits a live data endpoint (~15-30s) and appends a "live" block with the freshest price, stock, Buy Box seller, rating, and review count, plus data_as_of and is_stale flags. Unknown field values return an error with the full list of allowed fields.
- 2026-11-06 `compare_products` changed (description)
  - before: Compare two to five products side-by-side across dimensions. asins: a list of 2-5 valid ASINs (10-char alphanumeric, e.g. "B08N5WRWNW"). Fewer than 2 or more than 5 items returns an error.
  - after: Compare two to five products side-by-side across dimensions. asins: a list of 2-5 valid ASINs (10-char alphanumeric, e.g. "B08N5WRWNW"). Fewer than 2 or more than 5 items returns an error. facts_check reports, per ASIN, the five verdict counts across its fact-checked claims: corroborated, contradicted, insufficient, unmentioned_in_reviews, amz_not_disclosed.
- 2026-11-06 `get_product` changed (description)
  - before: Get a product's full profile: specs, full description, feature bullets, ratings, price, trend, dimension scores/percentiles, three-source facts check, red-flag signals, and sentiment. profile.full_description carries the complete listing description paragraph when available in the source listing; otherwise it is null (specifications and feature_bullets remain present).
  - after: Get a product's full profile: specs, full description, feature bullets, ratings, price, trend, dimension scores/percentiles, per-claim user-review facts check (facts_check), feature-level review verification (product_features), red-flag signals, and sentiment. profile.full_description carries the complete listing description paragraph when available in the source listing; otherwise it is null (specifications and feature_bullets remain present). product_features lists one record per seller-claimed feature in the seller's own order, each carrying its own user-review verdict; it is kept separate from feature_factors (category-level decision factors) and the two are never merged.
- 2026-11-05 `scrap_page` changed (description)
  - before: Scrape a product page in real time for the latest price, stock, Buy Box seller, rating, and review count. Typically returns in 3-10 seconds depending on network conditions. The response carries data_as_of (when the platform observed the data) and an is_stale flag for freshness judgment.
  - after: Scrape a product page in real time for the latest price, stock, Buy Box seller, rating, and review count. Typically returns in 15-30 seconds, excluding first-time cold start and queueing. The response carries data_as_of (when the platform observed the data) and an is_stale flag for freshness judgment.
- 2026-11-05 `search_products` changed (description, inputSchema)
  - before: Search for candidate products matching a query, each with a data-maturity tier. query: 1-8 space-separated plain words (no SQL/special chars). category_id: optional top-level category slug from list_categories (e.g. "pet-supplies"). sort (enum): price_asc | price_desc | rating_desc | review_count_desc. Omit for relevance order. Filters: min_price / max_price in USD (floats), min_rating on a 0-5 scale. Invalid values return an error listing the allowed enum.
  - after: Search for candidate products matching a query, each with a data-maturity tier. query: 1-8 space-separated plain words (no SQL/special chars). category_id: optional top-level category slug from list_categories (e.g. "pet-supplies"). sort (enum): price_asc | price_desc | rating_desc | review_count_desc. Omit for relevance order. Relevance (default order) weights title match (3) > brand match (2) > feature-bullet match (1) per term; every term must match at least one field. matched reports the total hit count (matched=0 means no product matched every term). limit (1-100, default 20) / offset paginate; include_rating_distribution (default false) adds the rating_breakdown histogram. Filters: min_price / max_price in USD (floats), min_rating on a 0-5 scale. Invalid values return an error listing the allowed enum.
- 2026-11-05 `get_sub_category_brief` changed (description, inputSchema)
  - before: Get a structured brief for all sub-categories (nodes) under a top-level category: market overview, considering factors, gotchas, common questions, needs, and keywords. Pass the top-level category_id from list_categories.
  - after: Get a structured brief for a category: market overview, considering factors, gotchas, common questions, needs, and keywords. Pass exactly one of: category_id (a top-level category slug from list_categories, e.g. "pet-supplies") to aggregate all sub-categories under it, or subcategory_id (a numeric node id from list_categories) to get a single node's own brief. Omitting both returns an error.
- 2026-11-05 `get_top100` changed (description, inputSchema)
  - before: Get the Amazon US Top-100 Best Sellers Rank list for a product category (US market only). Pass exactly one of: category_id (a top-level category slug from list_categories, e.g. "pet-supplies") or subcategory_id (a numeric subcategory node id from list_categories, e.g. "3742171"). Omitting both returns an error.
  - after: Get the Amazon US Top-100 Best Sellers Rank list for a product category (US market only). Pass exactly one of: category_id (a top-level category slug from list_categories, e.g. "pet-supplies") or subcategory_id (a numeric subcategory node id from list_categories, e.g. "3742171"). Omitting both returns an error. limit (1-100, default 100) and offset paginate the merged leaderboard; include_rating_distribution (default false) adds the rating_breakdown histogram.
- 2026-11-05 `get_category_brief` removed
  - Get a structured brief for a category: market overview, considering factors, gotchas, common questions, needs, and keywords.
- 2026-11-05 `get_sub_category_brief` added
  - Get a structured brief for all sub-categories (nodes) under a top-level category: market overview, considering factors, gotchas, common questions, needs, and keywords. Pass the top-level category_id from list_categories.
- 2026-11-04 `get_brand` added
  - Get a brand's full profile from the brand registry: tier, product count, cumulative review count, rating breakdown, seller positive percentage, subcategory monopoly HHI, 90-day trend, and ratings gained over 30/90 days. Pass a brand_name for an exact match, or a partial name to receive candidate matches.

Full history: https://api.protogrid.dev/v1/servers/com.asinrating%2Fasinrating/changes

## Remotes

- https://asinrating.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (11)

- `compare_products`: Compare two to five products side-by-side across dimensions.
asins: a list of 2-5 valid ASINs (10-char alphanumeric, e.g. "B08N5WRWNW").
Fewer than 2 or more than 5 items returns an error.
facts_check reports, per ASIN, the five verdict counts across its fact-checked claims:
corroborated, contradicted, insufficient, unmentioned_in_reviews, amz_not_disclosed.
- `get_brand`: Get a brand's full profile from the brand registry: tier, product count, cumulative review count, rating breakdown, seller positive percentage, subcategory monopoly HHI, 90-day trend, and ratings gained over 30/90 days. Pass a brand_name for an exact match, or a partial name to receive candidate matches.
- `get_price`: Get a product's latest price and product-page link.
- `get_price_change`: Get a product's 180-day price change summary from recorded history: current price, 180-day low/high/average, sample count, and where the current price sits among its own recorded observations. Answers "is now a good time to buy" style questions from historical data; it is a stored snapshot, not a real-time quote (call scrap_page for live price).
- `get_product`: Get a product's full profile: specs, full description, feature bullets, ratings, price,
trend, dimension scores/percentiles, per-claim user-review facts check (facts_check),
feature-level review verification (product_features), red-flag signals, and sentiment.
profile.full_description carries the complete listing description paragraph when available
in the source listing; otherwise it is null (specifications and feature_bullets remain present).
product_features lists one record per seller-claimed feature in the seller's own order, each
carrying its own user-review verdict; it is kept separate from feature_factors (category-level
decision factors) and the two are never merged.
- `get_sub_category_brief`: Get a structured brief for a category: market overview, considering factors, gotchas, common questions, needs, and keywords. Pass exactly one of: category_id (a top-level category slug from list_categories, e.g. "pet-supplies") to aggregate all sub-categories under it, or subcategory_id (a numeric node id from list_categories) to get a single node's own brief. Omitting both returns an error.
- `get_top100`: Get the Amazon US Top-100 Best Sellers Rank list for a product category (US market only).
Pass exactly one of: category_id (a top-level category slug from list_categories,
e.g. "pet-supplies") or subcategory_id (a numeric subcategory node id from
list_categories, e.g. "3742171"). Omitting both returns an error.
limit (1-100, default 100) and offset paginate the merged leaderboard; include_rating_distribution (default false) adds the rating_breakdown histogram.
- `list_categories`: List top-level Amazon US product categories and their subcategories covered by this service (US market only).
- `request`: Fetch structured data by URL or ASIN with optional field filters.
Pass either url (an Amazon product page URL) or asin (10-char alphanumeric).
fields (optional enum): profile | price | trend | ratings | competitiveness |
seller | facts_check | product_features | red_flags | sentiment | data_limitations.
live (optional, default false): when true, additionally hits a live data endpoint (~15-30s) and appends a "live" block with the freshest price, stock,
Buy Box seller, rating, and review count, plus data_as_of and is_stale flags.
Unknown field values return an error with the full list of allowed fields.
- `scrap_page`: Scrape a product page in real time for the latest price, stock, Buy Box seller, rating, and review count. Typically returns in 15-30 seconds, excluding first-time cold start and queueing. The response carries data_as_of (when the platform observed the data) and an is_stale flag for freshness judgment.
- `search_products`: Search for candidate products matching a query, each with a data-maturity tier.
query: 1-8 space-separated plain words (no SQL/special chars).
category_id: optional top-level category slug from list_categories (e.g. "pet-supplies").
sort (enum): price_asc | price_desc | rating_desc | review_count_desc. Omit for relevance order.
Relevance (default order) weights title match (3) > brand match (2) > feature-bullet match (1) per term; every term must match at least one field. matched reports the total hit count (matched=0 means no product matched every term). limit (1-100, default 20) / offset paginate; include_rating_distribution (default false) adds the rating_breakdown histogram.
Filters: min_price / max_price in USD (floats), min_rating on a 0-5 scale.
Invalid values return an error listing the allowed enum.