io.heartly/deals
Official3 toolsHeartly Deals — Live Flash Sales (Shopify & WooCommerce)
Live flash-sale inventory from verified Shopify and WooCommerce merchants worldwide.
Access live flash-sale inventory from verified Shopify and WooCommerce stores.
Captured live from the server via tools/list.
list_active_deals
List currently active flash-sale deals from verified Heartly merchants. Returns deals sorted by ending soonest. Filters are optional and combinable.
Parameters (4)
- countrystring
ISO 3166-1 alpha-2 country code. Filters to merchants whose shipping_countries include this code, plus merchants who ship worldwide.
- categorystring
Top-level product category, e.g. "fashion", "beauty", "electronics".
- min_discount_pctinteger
Minimum discount percentage. Only return deals at or above this value.
- ending_within_hoursinteger
Only return deals ending within this many hours from now.
search_deals_by_category
Search active deals filtered by category. The category argument is required. Other filters (country, min_discount_pct, ending_within_hours) are optional.
Parameters (4)
- countrystring
ISO 3166-1 alpha-2 country code. Filters to merchants whose shipping_countries include this code, plus merchants who ship worldwide.
- categorystringrequired
Top-level product category, e.g. "fashion", "beauty", "electronics".
- min_discount_pctinteger
Minimum discount percentage. Only return deals at or above this value.
- ending_within_hoursinteger
Only return deals ending within this many hours from now.
get_deal_by_id
Look up a single active deal by its Heartly internal id (UUID).
Parameters (1)
- idstringrequired
Heartly internal deal id (UUID).
README not available yet.
Install
claude_desktop_config.json
{
"mcpServers": {
"deals": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.heartly.io/"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.