Live flash-sale inventory from verified Shopify and WooCommerce merchants worldwide.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Look up a single active deal by its Heartly internal id (UUID).
Heartly internal deal id (UUID).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Look up a single active deal by its Heartly internal id (UUID).
| Argument | Type | Description |
|---|---|---|
| id* | string | Heartly internal deal id (UUID). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"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)."
}
}
}List currently active flash-sale deals from verified Heartly merchants. Returns deals sorted by ending soonest. Filters are optional and combinable.
| Argument | Type | Description |
|---|---|---|
| country | string | ISO 3166-1 alpha-2 country code. Filters to merchants whose shipping_countries include this code, plus merchants who ship worldwide. |
| category | string | Top-level product category, e.g. "fashion", "beauty", "electronics". |
| min_discount_pct | integer | Minimum discount percentage. Only return deals at or above this value. |
| ending_within_hours | integer | Only return deals ending within this many hours from now. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country": {
"type": "string",
"maxLength": 2,
"minLength": 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",
"maxLength": 64,
"minLength": 1,
"description": "Top-level product category, e.g. \"fashion\", \"beauty\", \"electronics\"."
},
"min_discount_pct": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Minimum discount percentage. Only return deals at or above this value."
},
"ending_within_hours": {
"type": "integer",
"maximum": 720,
"minimum": 1,
"description": "Only return deals ending within this many hours from now."
}
}
}Search active deals filtered by category. The category argument is required. Other filters (country, min_discount_pct, ending_within_hours) are optional.
| Argument | Type | Description |
|---|---|---|
| country | string | ISO 3166-1 alpha-2 country code. Filters to merchants whose shipping_countries include this code, plus merchants who ship worldwide. |
| category* | string | Top-level product category, e.g. "fashion", "beauty", "electronics". |
| min_discount_pct | integer | Minimum discount percentage. Only return deals at or above this value. |
| ending_within_hours | integer | Only return deals ending within this many hours from now. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"category"
],
"properties": {
"country": {
"type": "string",
"maxLength": 2,
"minLength": 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",
"maxLength": 64,
"minLength": 1,
"description": "Top-level product category, e.g. \"fashion\", \"beauty\", \"electronics\"."
},
"min_discount_pct": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Minimum discount percentage. Only return deals at or above this value."
},
"ending_within_hours": {
"type": "integer",
"maximum": 720,
"minimum": 1,
"description": "Only return deals ending within this many hours from now."
}
}
}