# Tosheroon

> Real-time Amazon prices, product search, 90-day history, AI forecasts, and price drop alerts.

- name: com.tosheroon/mcp
- version: 1.0.1
- connection class: R0 (autonomous)
- trust: 71/100 flags: no-repository
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.tosheroon%2Fmcp
- tools: https://api.protogrid.dev/v1/servers/com.tosheroon%2Fmcp/tools

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

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "tosheroon": {
      "type": "http",
      "url": "https://tosheroon.com/mcp",
      "headers": {
        "X-Api-Key": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`.

## Trust

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

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 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: 71 (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
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_products (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_price_drops (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); browse_by_brand (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,500 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 3 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

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

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

- tools: 12, about 1,500 tokens to load them all
- tool set hash: 1dbff985e0450395976a5e022dd707f1
- tools last changed: 2026-10-12T21:52:56.086Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.tosheroon/mcp.svg)](https://protogrid.dev/servers/com.tosheroon/mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-12 `get_product` changed (description)
  - before: Get detailed product information by product_id. Returns full product details including current price and affiliate buy link.
  - after: Get detailed product information by product_id. Returns full product details including current price and a link to the product's Tosheroon page, which links to Amazon.
- 2026-10-12 `get_product` changed (description)
  - before: Get detailed product information by product_id. Returns full product details including current price and a link to the product's Tosheroon page, which links to Amazon.
  - after: Get detailed product information by product_id. Returns full product details including current price and affiliate buy link.
- 2026-10-09 `get_product` changed (description)
  - before: Get detailed product information by product_id. Returns full product details including current price and affiliate buy link.
  - after: Get detailed product information by product_id. Returns full product details including current price and a link to the product's Tosheroon page, which links to Amazon.

Full history: https://api.protogrid.dev/v1/servers/com.tosheroon%2Fmcp/changes

## Remotes

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

## Packages

_none_

## Tools (12)

- `browse_by_brand`: Browse Amazon products by brand name. Returns products matching the given brand.
- `browse_by_category`: Browse Amazon products by category. Omit category to list all available categories. Provide a category name to get products in that category.
- `create_in_stock_alert`: Create a back-in-stock alert. You'll receive an email when the product becomes available again.
- `create_price_alert`: Create a price drop alert. You'll receive an email when the product drops to or below your target price.
- `get_price_drops`: Get Amazon products with recent significant price drops. Returns products sorted by drop percentage.
- `get_price_forecast`: Get a 30-day price forecast for a product. Requires sufficient price history. Returns predicted prices with confidence scores.
- `get_price_history`: Get price history for a product by product_id. Returns daily prices for up to 90 days.
- `get_price_statistics`: Get price statistics for a product (all-time high/low, mean, median, histogram). Uses cached data for performance.
- `get_product`: Get detailed product information by product_id. Returns full product details including current price and a link to the product's Tosheroon page, which links to Amazon.
- `get_similar_products`: Find products similar to a given product. Useful for discovering alternatives or related items.
- `register_api_key`: Register for a free API key to increase your rate limits from 20/min to 120/min. An API key will be emailed to you.
- `search_products`: Search for Amazon products by keyword, ASIN, or Amazon URL with optional filters for brand, category, price range, stock status, and sorting. Returns product IDs for use with other tools. Rate limited to 20 req/min without an API key — use the register_api_key tool for 120 req/min.