Tosheroon
Real-time Amazon prices, product search, 90-day history, AI forecasts, and price drop alerts.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'browse_by_brand' description lacks action verbin browse_by_brand
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"mcp": {
"url": "https://tosheroon.com/mcp"
}
}
}Remote endpoints
https://tosheroon.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢search_products(brand, category, in_stock, limit, max_price, ...)
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",
"properties": {
"brand": {
"description": "Filter by brand name (e.g. Apple, Samsung, Sony)",
"type": "string"
},
"category": {
"description": "Filter by category (e.g. Laptops, Headphones, TVs)",
"type": "string"
},
"in_stock": {
"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.",
"type": "boolean"
},
"limit": {
"default": 20,
"description": "Number of results to return (1-50). Defaults to 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"max_price": {
"description": "Maximum price in the region's currency (e.g. 500 for £500)",
"type": "number"
},
"min_price": {
"description": "Minimum price in the region's currency (e.g. 100 for £100)",
"type": "number"
},
"query": {
"description": "Search keyword, Amazon ASIN (e.g. B08N5WRWNW), or Amazon product URL. Optional when using brand/category filters.",
"type": "string"
},
"region": {
"default": "uk",
"description": "Country code (e.g. uk, us, de). Defaults to uk.",
"type": "string"
},
"sort_by": {
"default": "relevance",
"description": "Sort order for results. Defaults to relevance.",
"enum": [
"relevance",
"price_asc",
"price_desc",
"newest"
],
"type": "string"
}
},
"required": []
}🟢get_product(product_id)
Get detailed product information by product_id. Returns full product details including current price and affiliate buy link.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"description": "The product ID returned by search_products or other discovery tools",
"type": "integer"
}
},
"required": [
"product_id"
]
}🟢get_price_history(days, product_id)
Get price history for a product by product_id. Returns daily prices for up to 90 days.
Input Schema
{
"type": "object",
"properties": {
"days": {
"default": 90,
"description": "Number of days of history to return (1-90). Defaults to 90.",
"maximum": 90,
"minimum": 1,
"type": "integer"
},
"product_id": {
"description": "The product ID returned by search_products or other discovery tools",
"type": "integer"
}
},
"required": [
"product_id"
]
}🔴get_price_drops(limit, region)
Get Amazon products with recent significant price drops. Returns products sorted by drop percentage.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"default": 10,
"description": "Number of results to return (1-20). Defaults to 10.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"region": {
"default": "uk",
"description": "Country code (e.g. uk, us, de). Defaults to uk.",
"type": "string"
}
},
"required": []
}🟢browse_by_category(category, limit, region)
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",
"properties": {
"category": {
"description": "Category name to browse. Omit to list all available categories.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Number of products to return (1-50). Defaults to 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"region": {
"default": "uk",
"description": "Country code (e.g. uk, us, de). Defaults to uk.",
"type": "string"
}
},
"required": []
}⚪browse_by_brand(brand, limit, region)
Browse Amazon products by brand name. Returns products matching the given brand.
Input Schema
{
"type": "object",
"properties": {
"brand": {
"description": "Brand name to search for (e.g. Sony, Apple, Samsung)",
"type": "string"
},
"limit": {
"default": 20,
"description": "Number of products to return (1-50). Defaults to 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"region": {
"default": "uk",
"description": "Country code (e.g. uk, us, de). Defaults to uk.",
"type": "string"
}
},
"required": [
"brand"
]
}🟢get_price_statistics(product_id)
Get price statistics for a product (all-time high/low, mean, median, histogram). Uses cached data for performance.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"description": "The product ID returned by search_products or other discovery tools",
"type": "integer"
}
},
"required": [
"product_id"
]
}🟢get_price_forecast(product_id)
Get a 30-day price forecast for a product. Requires sufficient price history. Returns predicted prices with confidence scores.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"description": "The product ID returned by search_products or other discovery tools",
"type": "integer"
}
},
"required": [
"product_id"
]
}🔴create_price_alert(email, product_id, target_price)
Create a price drop alert. You'll receive an email when the product drops to or below your target price.
Input Schema
{
"type": "object",
"properties": {
"email": {
"description": "The email address to send the alert to",
"type": "string"
},
"product_id": {
"description": "The product ID returned by search_products or other discovery tools",
"type": "integer"
},
"target_price": {
"description": "The target price — alert is sent when the product drops to or below this price",
"type": "number"
}
},
"required": [
"product_id",
"email",
"target_price"
]
}🟡create_in_stock_alert(email, product_id)
Create a back-in-stock alert. You'll receive an email when the product becomes available again.
Input Schema
{
"type": "object",
"properties": {
"email": {
"description": "The email address to send the alert to",
"type": "string"
},
"product_id": {
"description": "The product ID returned by search_products or other discovery tools",
"type": "integer"
}
},
"required": [
"product_id",
"email"
]
}🟢get_similar_products(limit, product_id)
Find products similar to a given product. Useful for discovering alternatives or related items.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"default": 6,
"description": "Number of similar products to return (1-20). Defaults to 6.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"product_id": {
"description": "The product ID to find similar products for",
"type": "integer"
}
},
"required": [
"product_id"
]
}⚪register_api_key(email)
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",
"properties": {
"email": {
"description": "Your email address. The API key will be sent here.",
"type": "string"
}
},
"required": [
"email"
]
}Community
Evidence