MCP Server

Tosheroon

com.tosheroon/mcp
Commerce & Retail Data & Analytics Public & reachable MCP 2025-11-25

What this MCP does

Searches Amazon products and provides product details, price history and statistics, price-drop detection, forecasts, similar products, and price or stock alerts.

browse_by_brand
Browse Amazon products by brand name. Returns products matching the given brand.
Input schema
{'type': 'object', 'required': ['brand'], 'properties': {'brand': {'type': 'string', 'description': 'Brand name to search for (e.g. Sony, Apple, Samsung)'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Number of products to return (1-50). Defaults to 20.'}, 'region': {'type': 'string', 'default': 'uk', 'description': 'Country code (e.g. uk, us, de). Defaults to uk.'}}}
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.
Input schema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Number of products to return (1-50). Defaults to 20.'}, 'region': {'type': 'string', 'default': 'uk', 'description': 'Country code (e.g. uk, us, de). Defaults to uk.'}, 'category': {'type': 'string', 'description': 'Category name to browse. Omit to list all available categories.'}}}
create_in_stock_alert
Create a back-in-stock alert. You'll receive an email when the product becomes available again.
Input schema
{'type': 'object', 'required': ['product_id', 'email'], 'properties': {'email': {'type': 'string', 'description': 'The email address to send the alert to'}, 'product_id': {'type': 'integer', 'description': 'The product ID returned by search_products or other discovery tools'}}}
create_price_alert
Create a price drop alert. You'll receive an email when the product drops to or below your target price.
Input schema
{'type': 'object', 'required': ['product_id', 'email', 'target_price'], 'properties': {'email': {'type': 'string', 'description': 'The email address to send the alert to'}, 'product_id': {'type': 'integer', 'description': 'The product ID returned by search_products or other discovery tools'}, 'target_price': {'type': 'number', 'description': 'The target price — alert is sent when the product drops to or below this price'}}}
get_price_drops
Get Amazon products with recent significant price drops. Returns products sorted by drop percentage.
Input schema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 20, 'minimum': 1, 'description': 'Number of results to return (1-20). Defaults to 10.'}, 'region': {'type': 'string', 'default': 'uk', 'description': 'Country code (e.g. uk, us, de). Defaults to uk.'}}}
get_price_forecast
Get a 30-day price forecast for a product. Requires sufficient price history. Returns predicted prices with confidence scores.
Input schema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'integer', 'description': 'The product ID returned by search_products or other discovery tools'}}}
get_price_history
Get price history for a product by product_id. Returns daily prices for up to 90 days.
Input schema
{'type': 'object', 'required': ['product_id'], 'properties': {'days': {'type': 'integer', 'default': 90, 'maximum': 90, 'minimum': 1, 'description': 'Number of days of history to return (1-90). Defaults to 90.'}, 'product_id': {'type': 'integer', 'description': 'The product ID returned by search_products or other discovery tools'}}}
get_price_statistics
Get price statistics for a product (all-time high/low, mean, median, histogram). Uses cached data for performance.
Input schema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'integer', 'description': 'The product ID returned by search_products or other discovery tools'}}}
get_product
Get detailed product information by product_id. Returns full product details including current price and affiliate buy link.
Input schema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'integer', 'description': 'The product ID returned by search_products or other discovery tools'}}}
get_similar_products
Find products similar to a given product. Useful for discovering alternatives or related items.
Input schema
{'type': 'object', 'required': ['product_id'], 'properties': {'limit': {'type': 'integer', 'default': 6, 'maximum': 20, 'minimum': 1, 'description': 'Number of similar products to return (1-20). Defaults to 6.'}, 'product_id': {'type': 'integer', 'description': 'The product ID to find similar products for'}}}
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.
Input schema
{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'Your email address. The API key will be sent here.'}}}
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.
Input schema
{'type': 'object', 'required': [], 'properties': {'brand': {'type': 'string', 'description': 'Filter by brand name (e.g. Apple, Samsung, Sony)'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Number of results to return (1-50). Defaults to 20.'}, 'query': {'type': 'string', 'description': 'Search keyword, Amazon ASIN (e.g. B08N5WRWNW), or Amazon product URL. Optional when using brand/category filters.'}, 'region': {'type': 'string', 'default': 'uk', 'description': 'Country code (e.g. uk, us, de). Defaults to uk.'}, 'sort_by': {'enum': ['relevance', 'price_asc', 'price_desc', 'newest'], 'type': 'string', 'default': 'relevance', 'description': 'Sort order for results. Defaults to relevance.'}, 'category': {'type': 'string', 'description': 'Filter by category (e.g. Laptops, Headphones, TVs)'}, 'in_stock': {'type': 'boolean', 'default': True, 'description': 'When true, only returns in-stock products. When false, returns both in-stock and out-of-stock products (it does NOT filter to out-of-stock only). Defaults to true.'}, 'max_price': {'type': 'number', 'description': "Maximum price in the region's currency (e.g. 500 for £500)"}, 'min_price': {'type': 'number', 'description': "Minimum price in the region's currency (e.g. 100 for £100)"}}}
Added
register_api_key
Sept. 17, 2026, 12:38 p.m.
Added
get_similar_products
Sept. 17, 2026, 12:38 p.m.
Added
create_in_stock_alert
Sept. 17, 2026, 12:38 p.m.
Added
create_price_alert
Sept. 17, 2026, 12:38 p.m.
Added
get_price_forecast
Sept. 17, 2026, 12:38 p.m.
Added
get_price_statistics
Sept. 17, 2026, 12:38 p.m.
Added
browse_by_brand
Sept. 17, 2026, 12:38 p.m.
Added
browse_by_category
Sept. 17, 2026, 12:38 p.m.
Added
get_price_drops
Sept. 17, 2026, 12:38 p.m.
Added
get_price_history
Sept. 17, 2026, 12:38 p.m.
Added
get_product
Sept. 17, 2026, 12:38 p.m.
Added
search_products
Sept. 17, 2026, 12:38 p.m.