MCP Server

Remode - Visual Fashion Shopping

io.github.deviljin17/remode
Commerce & Retail Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Finds fashion products from text, images, links, or product pages, compares prices, and tracks items for lower prices or resale matches.

check_price
Compare a fashion product
Use this when the user provides one specific fashion product-page URL and asks whether the same item is available elsewhere, cheaper, second-hand, or from another retailer. Remode compares the exact product first and labels merely similar alternatives separately. This is a one-time comparison: it never starts monitoring. Use it for requests that ask for results now, including 'hunt down cheaper options right now'. If the shopper clearly asks Remode to keep watching the item (keep looking, alert or notify me, tell me when, start a Hunt), call watch_item instead; if that is unclear, run this comparison and offer to start a Hunt. Pass the shopper's size when they state one. Do not use for a photo without a product URL, generic product discovery, styling advice, or non-fashion products.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_url'], 'properties': {'size': {'type': 'string', 'maxLength': 24, 'minLength': 1, 'description': "The shopper's size exactly as they wrote it, such as M, XL or EU 50, when they stated one. Used to match second-hand listings; never assume it was applied unless the result's second_hand_gate says so."}, 'region': {'type': 'string', 'maxLength': 8, 'minLength': 2, 'description': 'Two-letter shopping region/country code, such as US, CH, DE, or GB.'}, 'max_results': {'type': 'integer', 'maximum': 15, 'minimum': 1}, 'product_url': {'type': 'string', 'format': 'uri', 'description': 'Public retailer product-page URL for the exact fashion item to compare.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'app_url'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'region': {'type': 'string'}, 'app_url': {'type': 'string', 'format': 'uri'}, 'message': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'price', 'currency', 'retailer', 'url', 'image', 'second_hand', 'match'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'image': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'match': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean'}, 'retailer': {'type': 'string'}, 'save_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'watch_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'market_fit': {'enum': ['local', 'nearby', 'non_local', 'unknown'], 'type': 'string'}, 'remode_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'try_on_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'second_hand': {'type': 'boolean'}, 'storefront_regions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'is_exact_match_hard': {'type': 'boolean'}}, 'additionalProperties': False}}, 'second_hand': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'price', 'currency', 'retailer', 'url', 'image', 'second_hand', 'match'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'image': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'match': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean'}, 'retailer': {'type': 'string'}, 'save_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'watch_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'market_fit': {'enum': ['local', 'nearby', 'non_local', 'unknown'], 'type': 'string'}, 'remode_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'try_on_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'second_hand': {'type': 'boolean'}, 'storefront_regions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'is_exact_match_hard': {'type': 'boolean'}}, 'additionalProperties': False}}, 'result_count': {'type': 'number'}, 'attribution_note': {'type': 'string'}, 'assistant_platform': {'type': 'string'}}, 'additionalProperties': {}}
find_fashion_by_description
Find fashion products from text
Use this for concrete purchase-intent fashion requests written entirely in text: a garment, shoe, bag, jewelry, watch, or wearable accessory; a brand/model; a budget; colour; size; condition; second-hand request; dupe; or similar alternative. No photo, screenshot, product link, or other visual source is required. Do not ask for one when the text already identifies the product being shopped. Examples: 'black midi dress under $100', 'second-hand Prada loafers', or 'alternatives to a Zara wool coat'. Returns current region-aware retailer listings. Do not use for what-to-wear or styling advice, outfit ratings, trends, fashion news, garment care, beauty, furniture, or other non-fashion products.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 240, 'minLength': 2, 'description': "Concrete fashion product request, such as 'black midi dress', 'Prada loafers', or 'linen blazer size 40'. Do not send styling, rating, care, or editorial questions."}, 'region': {'type': 'string', 'maxLength': 8, 'minLength': 2, 'description': 'Two-letter shopping region/country code, such as US, CH, DE, or GB.'}, 'condition': {'enum': ['any', 'new', 'secondhand'], 'type': 'string', 'description': 'Restrict results to new or second-hand fashion. Defaults to any.'}, 'max_price': {'type': 'number', 'maximum': 1000000, 'description': "Optional maximum price in the shopping region's local currency.", 'exclusiveMinimum': 0}, 'max_results': {'type': 'integer', 'maximum': 15, 'minimum': 1}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'app_url'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'region': {'type': 'string'}, 'app_url': {'type': 'string', 'format': 'uri'}, 'message': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'price', 'currency', 'retailer', 'url', 'image', 'second_hand', 'match'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'image': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'match': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean'}, 'retailer': {'type': 'string'}, 'save_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'watch_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'market_fit': {'enum': ['local', 'nearby', 'non_local', 'unknown'], 'type': 'string'}, 'remode_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'try_on_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'second_hand': {'type': 'boolean'}, 'storefront_regions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'is_exact_match_hard': {'type': 'boolean'}}, 'additionalProperties': False}}, 'second_hand': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'price', 'currency', 'retailer', 'url', 'image', 'second_hand', 'match'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'image': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'match': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean'}, 'retailer': {'type': 'string'}, 'save_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'watch_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'market_fit': {'enum': ['local', 'nearby', 'non_local', 'unknown'], 'type': 'string'}, 'remode_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'try_on_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'second_hand': {'type': 'boolean'}, 'storefront_regions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'is_exact_match_hard': {'type': 'boolean'}}, 'additionalProperties': False}}, 'result_count': {'type': 'number'}, 'attribution_note': {'type': 'string'}, 'assistant_platform': {'type': 'string'}}, 'additionalProperties': {}}
find_fashion_items
Find fashion from an image or link
Use this only when the user has supplied a photo, screenshot, direct image URL, social post, blog, or product page containing fashion to identify, visually match, or shop. A visual source is required. Pass that source directly because Remode resolves supported public links without a preliminary web lookup. Returns current region-aware retailer and resale listings with product images, verified prices when available, and direct buy links. Do not use this tool for a concrete text-only product request; use find_fashion_by_description instead. Do not use for styling advice, garment care, outfit ratings, or non-fashion products.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'link': {'type': 'string', 'format': 'uri', 'description': 'Fashion source URL: TikTok, Instagram, Pinterest, retailer product page, blog, or direct image.'}, 'region': {'type': 'string', 'maxLength': 8, 'minLength': 2, 'description': 'Two-letter shopping region/country code, such as US, CH, DE, or GB.'}, 'image_url': {'type': 'string', 'format': 'uri', 'description': 'Direct HTTPS image URL to run through Remode visual search.'}, 'image_file': {'type': 'object', 'required': ['download_url'], 'properties': {'file_id': {'type': 'string', 'minLength': 1, 'description': 'Stable file identifier supplied by the assistant host when available.'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string'}, 'download_url': {'type': 'string', 'format': 'uri', 'description': 'Temporary HTTPS URL supplied by the assistant host for an uploaded image.'}}, 'description': 'Image file uploaded by the user. ChatGPT supplies this via _meta.openai/fileParams.', 'additionalProperties': {}}, 'max_results': {'type': 'integer', 'maximum': 15, 'minimum': 1, 'description': 'Maximum new retail matches to return. Defaults to the backend setting.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'app_url'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'region': {'type': 'string'}, 'app_url': {'type': 'string', 'format': 'uri'}, 'message': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'price', 'currency', 'retailer', 'url', 'image', 'second_hand', 'match'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'image': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'match': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean'}, 'retailer': {'type': 'string'}, 'save_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'watch_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'market_fit': {'enum': ['local', 'nearby', 'non_local', 'unknown'], 'type': 'string'}, 'remode_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'try_on_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'second_hand': {'type': 'boolean'}, 'storefront_regions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'is_exact_match_hard': {'type': 'boolean'}}, 'additionalProperties': False}}, 'second_hand': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'price', 'currency', 'retailer', 'url', 'image', 'second_hand', 'match'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'image': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'match': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean'}, 'retailer': {'type': 'string'}, 'save_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'watch_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'market_fit': {'enum': ['local', 'nearby', 'non_local', 'unknown'], 'type': 'string'}, 'remode_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'try_on_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'second_hand': {'type': 'boolean'}, 'storefront_regions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'is_exact_match_hard': {'type': 'boolean'}}, 'additionalProperties': False}}, 'result_count': {'type': 'number'}, 'attribution_note': {'type': 'string'}, 'assistant_platform': {'type': 'string'}}, 'additionalProperties': {}}
get_watch_updates
Get watch updates
Read the linked user's active Hunts, stored requested criteria and recorded historical alerts. Use before editing an existing Hunt to preserve unmentioned terms and select its returned watch_id. Stored requested sizes/budgets and alert clocks do not prove current price, stock, fit or delivery. Returns a bounded list; has_more=true means additional Hunts are omitted. Use when the user asks what Remode is watching or whether anything changed.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'watch_id': {'type': 'string', 'maxLength': 80, 'minLength': 1}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'watches', 'updates', 'watch_ids'], 'properties': {'ok': {'type': 'boolean', 'const': True}, 'updates': {'type': 'array', 'items': {'type': 'object', 'required': ['update_id', 'watch_id', 'kind', 'title', 'url', 'store', 'currency', 'created_at'], 'properties': {'url': {'type': 'string'}, 'kind': {'type': 'string'}, 'store': {'type': 'string'}, 'title': {'type': 'string'}, 'currency': {'type': 'string'}, 'watch_id': {'type': 'string'}, 'new_price': {'anyOf': [{}, {'type': 'null'}]}, 'old_price': {'anyOf': [{}, {'type': 'null'}]}, 'update_id': {'type': 'string'}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verified_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price_evidence': {'type': 'string', 'const': 'historical_alert'}, 'delivery_status': {'enum': ['pending', 'unknown', 'accepted', 'unconfirmed'], 'type': 'string'}, 'mandate_evidence': {'type': 'string', 'const': 'historical_not_current_revision_proof'}, 'current_availability': {'type': 'string', 'const': 'unknown'}, 'delivery_accepted_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'watches': {'type': 'array', 'items': {'type': 'object', 'required': ['watch_id', 'status', 'active', 'title', 'url', 'image_url', 'price', 'currency', 'region', 'preferences', 'last_checked_at', 'updated_at'], 'properties': {'url': {'type': 'string'}, 'price': {'type': 'string'}, 'title': {'type': 'string'}, 'active': {'type': 'boolean'}, 'region': {'type': 'string'}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'watch_id': {'type': 'string'}, 'image_url': {'type': 'string'}, 'updated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'preferences': {'type': 'array', 'items': {'enum': ['lower_price', 'second_hand'], 'type': 'string'}}, 'last_checked_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested_terms': {'type': 'object', 'required': ['evidence'], 'properties': {'size': {'type': 'string', 'maxLength': 24}, 'color': {'type': 'string', 'maxLength': 40}, 'evidence': {'type': 'string', 'const': 'stored_mandate'}, 'condition': {'enum': ['new', 'pre_owned', 'any'], 'type': 'string'}, 'price_target': {'oneOf': [{'type': 'object', 'required': ['mode', 'amount', 'currency'], 'properties': {'mode': {'type': 'string', 'const': 'absolute'}, 'amount': {'type': 'number', 'maximum': 10000000, 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['mode', 'amount', 'currency', 'percent_off'], 'properties': {'mode': {'type': 'string', 'const': 'percent_off'}, 'amount': {'type': 'number', 'maximum': 10000000, 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'percent_off': {'type': 'number', 'exclusiveMaximum': 100, 'exclusiveMinimum': 0}}, 'additionalProperties': False}]}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'has_more': {'type': 'boolean'}, 'watch_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
stop_watching_item
Stop watching an item
Stop an existing Remode watch. Use only after the user asks to stop tracking an item. Requires the stable watch_id returned by Remode.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watch_id'], 'properties': {'watch_id': {'type': 'string', 'maxLength': 80, 'minLength': 1}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'watch_id', 'stopped', 'removed_from_saved'], 'properties': {'ok': {'type': 'boolean', 'const': True}, 'stopped': {'type': 'boolean'}, 'watch_id': {'type': 'string'}, 'removed_from_saved': {'type': 'boolean'}}, 'additionalProperties': False}
update_watch
Update a watch
Edit criteria for an existing Hunt using its returned watch_id. Read get_watch_updates first. Use operation add to preserve existing criteria when the shopper asks for another lane; remove to drop a lane; replace only for an explicit complete change. Removing lower_price also deletes its saved price target; disclose that consequence before the change. No size or budget editing is supported here. Never change a Hunt unless the user asks, and read its state after a timeout or conflict before deciding whether to retry.
Destructive
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watch_id', 'preferences'], 'properties': {'watch_id': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'operation': {'enum': ['add', 'remove', 'replace'], 'type': 'string', 'description': "Use add for 'also find second-hand', remove to drop a criterion, or replace for an explicitly requested full change. Defaults to replace for existing clients. Removing lower_price also removes its saved price target."}, 'preferences': {'type': 'array', 'items': {'enum': ['lower_price', 'second_hand'], 'type': 'string'}, 'maxItems': 2, 'minItems': 1, 'description': 'Criteria to add, remove or replace. For replace, send the complete desired set; omitted criteria are removed.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'watch'], 'properties': {'ok': {'type': 'boolean', 'const': True}, 'watch': {'type': 'object', 'required': ['watch_id', 'status', 'active', 'title', 'url', 'image_url', 'price', 'currency', 'region', 'preferences', 'last_checked_at', 'updated_at'], 'properties': {'url': {'type': 'string'}, 'price': {'type': 'string'}, 'title': {'type': 'string'}, 'active': {'type': 'boolean'}, 'region': {'type': 'string'}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'watch_id': {'type': 'string'}, 'image_url': {'type': 'string'}, 'updated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'preferences': {'type': 'array', 'items': {'enum': ['lower_price', 'second_hand'], 'type': 'string'}}, 'last_checked_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requested_terms': {'type': 'object', 'required': ['evidence'], 'properties': {'size': {'type': 'string', 'maxLength': 24}, 'color': {'type': 'string', 'maxLength': 40}, 'evidence': {'type': 'string', 'const': 'stored_mandate'}, 'condition': {'enum': ['new', 'pre_owned', 'any'], 'type': 'string'}, 'price_target': {'oneOf': [{'type': 'object', 'required': ['mode', 'amount', 'currency'], 'properties': {'mode': {'type': 'string', 'const': 'absolute'}, 'amount': {'type': 'number', 'maximum': 10000000, 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['mode', 'amount', 'currency', 'percent_off'], 'properties': {'mode': {'type': 'string', 'const': 'percent_off'}, 'amount': {'type': 'number', 'maximum': 10000000, 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'percent_off': {'type': 'number', 'exclusiveMaximum': 100, 'exclusiveMinimum': 0}}, 'additionalProperties': False}]}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}
watch_item
Track a fashion product in Remode
Create or refresh an account-linked Hunt for a specific fashion product URL. Call this only when the shopper clearly wants Remode to keep watching this item over time: keep watching or looking, watch it for a lower price or second-hand options, alert or notify me, tell me or let me know when, start a Hunt, or an ask to hunt it for them that also asks what Remode will watch for, for example 'Hunt this for me and tell me what you will watch for, my size is M, I live in Switzerland': pass url, size exactly as the shopper wrote it, and region as a country code. A hypothetical or informational question about Hunts ('what would a Hunt watch for?', 'how does a Hunt work?') is not a request to start one: answer it without a write and offer to start a Hunt. A request for results now ('hunt down cheaper options for this link right now', 'find me', 'is it cheaper') is a one-time comparison: use check_price and never create a Hunt. If it is unclear whether the shopper wants ongoing watching, use check_price and offer to start a Hunt. After the call, tell the shopper what the returned text says Remode will watch for and what it cannot promise, and add nothing else. A new hunt request needs no earlier read; read existing Hunts first only when the shopper refers to a Hunt they already have, because this can replace an existing Hunt's terms. Use update_watch for criteria edits; do not re-create an existing Hunt unless the shopper explicitly requests a replacement and all desired terms can be represented. Percent-off targets cannot be set here. Exact item only: the Hunt never widens to similar items. Optional terms: same-currency max_price, condition, and size supported by a retailer variant record. Explicit in_stock=false can enable restock monitoring; never infer stock. Persisted state and ongoing monitoring are inside Remode; this is not a ChatGPT Scheduled task or a one-time notification; do not schedule it.
Destructive Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 4096, 'description': 'Retailer product URL from a Remode result.'}, 'size': {'type': 'string', 'maxLength': 24, 'minLength': 1, 'description': "The shopper's size as the store labels it. Remode applies it only when it can read the store's own per-size stock; otherwise the watch continues for the exact item without a size and the result says so."}, 'color': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': "The exact item's colour as the store names it. When the store sells the item in several colours, a size is applied only together with one of the store's own colour labels; on a single-colour product page the size is applied without a colour."}, 'price': {'type': 'string', 'maxLength': 40, 'description': 'Visible current price including currency when known.'}, 'title': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'region': {'type': 'string', 'maxLength': 8, 'minLength': 2, 'description': 'Shopping country code, such as US, CH, DE, or GB.'}, 'in_stock': {'type': 'boolean'}, 'condition': {'enum': ['new', 'pre_owned', 'any'], 'type': 'string', 'description': 'Say-when condition for this exact item: new (new listings only; second-hand listings never count), pre_owned (second hand), or any (both). Use instead of preferences.'}, 'image_url': {'type': 'string', 'format': 'uri', 'maxLength': 4096}, 'max_price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number', 'maximum': 10000000, 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'ISO currency code, such as CHF, EUR, USD.'}}, 'description': "Price finish line for this exact item: alert only at or below this price, in this currency. Must be the item's own currency; Remode never converts currencies. Requires condition new or any."}, 'preferences': {'type': 'array', 'items': {'enum': ['lower_price', 'second_hand'], 'type': 'string'}, 'maxItems': 2, 'minItems': 1, 'description': 'What Remode should look for. Defaults to lower price and second hand.'}, 'use_saved_size': {'enum': ['tops', 'bottoms', 'shoes'], 'type': 'string', 'description': "Use the shopper's saved usual size for this category as the size, when size is not given. Read-only; never changes the saved sizes."}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'watched', 'watch_id', 'region', 'preferences'], 'properties': {'ok': {'type': 'boolean', 'const': True}, 'size': {'type': 'object', 'required': ['requested', 'origin', 'applied'], 'properties': {'note': {'type': 'string', 'maxLength': 400}, 'scope': {'type': 'string', 'const': 'search_criterion'}, 'origin': {'enum': ['request', 'profile'], 'type': 'string'}, 'reason': {'type': 'string'}, 'source': {'type': 'string', 'const': 'shopper'}, 'applied': {'type': 'boolean'}, 'evidence': {'type': 'string'}, 'requested': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'store_label': {'type': 'string'}, 'color_options': {'type': 'array', 'items': {'type': 'string'}}, 'store_restock_promise': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'region': {'type': 'string'}, 'watched': {'type': 'boolean', 'const': True}, 'watch_id': {'type': 'string'}, 'preferences': {'type': 'array', 'items': {'enum': ['lower_price', 'second_hand'], 'type': 'string'}}, 'price_target': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
Changed
watch_item
Oct. 5, 2026, 2:45 a.m.
Changed
check_price
Oct. 5, 2026, 2:45 a.m.
Changed
stop_watching_item
Oct. 3, 2026, 2:52 a.m.
Changed
update_watch
Oct. 3, 2026, 2:52 a.m.
Changed
get_watch_updates
Oct. 3, 2026, 2:52 a.m.
Changed
watch_item
Oct. 3, 2026, 2:52 a.m.
Changed
get_watch_updates
Oct. 1, 2026, 2:45 a.m.
Changed
watch_item
Sept. 27, 2026, 2:44 a.m.
Changed
find_fashion_by_description
Sept. 27, 2026, 2:44 a.m.
Changed
check_price
Sept. 27, 2026, 2:44 a.m.
Changed
find_fashion_items
Sept. 27, 2026, 2:44 a.m.
Added
stop_watching_item
Sept. 17, 2026, 12:41 p.m.
Added
update_watch
Sept. 17, 2026, 12:41 p.m.
Added
get_watch_updates
Sept. 17, 2026, 12:41 p.m.
Added
watch_item
Sept. 17, 2026, 12:41 p.m.
Added
find_fashion_by_description
Sept. 17, 2026, 12:41 p.m.
Added
check_price
Sept. 17, 2026, 12:41 p.m.
Added
find_fashion_items
Sept. 17, 2026, 12:41 p.m.