Heartly Deals — Live Flash Sales (Shopify & WooCommerce)
Live flash-sale inventory from verified Shopify and WooCommerce merchants worldwide.
Should I use this
Quality & Safety
Findings (1)
- LOWin get_deal_by_id
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": {
"deals": {
"url": "https://mcp.heartly.io/"
}
}
}Remote endpoints
https://mcp.heartly.io/streamable-httpWhat it can do
Tool inventory
Tools (3)
🟢list_active_deals(country, category, min_discount_pct, ending_within_hours)
List currently active flash-sale deals from verified Heartly merchants. Returns deals sorted by ending soonest. Filters are optional and combinable.
Input Schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 country code. Filters to merchants whose shipping_countries include this code, plus merchants who ship worldwide."
},
"category": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Top-level product category, e.g. \"fashion\", \"beauty\", \"electronics\"."
},
"min_discount_pct": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Minimum discount percentage. Only return deals at or above this value."
},
"ending_within_hours": {
"type": "integer",
"minimum": 1,
"maximum": 720,
"description": "Only return deals ending within this many hours from now."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_deals_by_category(country, category, min_discount_pct, ending_within_hours)
Search active deals filtered by category. The category argument is required. Other filters (country, min_discount_pct, ending_within_hours) are optional.
Input Schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 country code. Filters to merchants whose shipping_countries include this code, plus merchants who ship worldwide."
},
"category": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Top-level product category, e.g. \"fashion\", \"beauty\", \"electronics\"."
},
"min_discount_pct": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Minimum discount percentage. Only return deals at or above this value."
},
"ending_within_hours": {
"type": "integer",
"minimum": 1,
"maximum": 720,
"description": "Only return deals ending within this many hours from now."
}
},
"required": [
"category"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_deal_by_id(id)
Look up a single active deal by its Heartly internal id (UUID).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Heartly internal deal id (UUID)."
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Recommended Prompts
search_deals_by_categorysearch_deals_by_categoryget_deal_by_idget_deal_by_idlist_active_dealsCommunity
Evidence