Developer documentation · MCP
Remode for AI assistants
Turn a fashion photo, product link or concrete description into retailer and resale options. Remode searches and compares; the shopper stays in control.
Connect
Streamable HTTP · JSON-RPC 2.0 · HTTPS
https://remode-assistant-mcp.onrender.com/mcp
Search is public: no Remode account, API key or payment is required. Initialize the MCP connection, call tools/list for the current schemas, then tools/call. Accept both application/json and text/event-stream.
Tools and permissions
| Tool | Purpose | readOnlyHint | destructiveHint | openWorldHint |
|---|---|---|---|---|
find_fashion_items | Photo, screenshot, direct image or supported public link. One source per call. | true | false | true |
find_fashion_by_description | Concrete fashion shopping by description, budget and condition. | true | false | true |
check_price | Compare one fashion product page; exact and similar results stay separate. | true | false | true |
watch_item | Create or reuse a Watch for a product the user explicitly chooses. | false | false | false |
get_watch_updates | Read the linked account’s Watches and verified updates. | true | false | false |
update_watch | Change the user’s lower-price / second-hand Watch preferences. | false | false | false |
stop_watching_item | Stop one of the linked user’s Watches. | false | true | false |
All seven tools declare idempotentHint: true. Hints describe intended behavior; enforce user consent and account authorization independently. Search tools access external commerce sources. Watch tools access the linked user’s Remode state.
Optional account linking
Watch tools require an explicitly linked Remode account. OAuth authorization code flow with PKCE S256, refresh tokens and scope watch:manage; public clients use token endpoint authentication none. Search does not require this scope. Disconnected Watch calls return an MCP OAuth challenge.
Resource: https://remode-assistant-mcp.onrender.com/mcp. Authorization requires state, resource and PKCE. Dynamic client registration is not supported. Contact support to register a dedicated client ID and exact HTTPS callback URL before testing account linking. Do not guess a callback or reuse another host’s client.
Regions, results and limits
Pass the shopper’s requested two-letter country code explicitly; omitted region defaults to US. Core markets include US (USD), GB (GBP), DE and AT (EUR). Other country codes may map to a supported market. Merchant availability and shipping are not guaranteed. Preserve each offer’s returned currency; never convert or relabel a foreign price without an exchange-rate source.
- Text query: 2–240 characters.
max_results: 1–15 per result group. condition:any,new,secondhand.max_price: positive amount in the resolved shopping market’s currency.- Watch updates:
limit1–25. Preferences:lower_price,second_hand.
Public search is capacity-limited, not unlimited. The backend applies a shared daily search allowance (code default: 300 per process, configurable); this is not a per-person entitlement or an integration SLA. Exhaustion returns daily_capacity_reached with retry guidance. Provider failures and timeouts are errors, not proof that no product exists. Use bounded retries and contact support for integration capacity.
Present results faithfully
Use returned titles, prices, currencies and merchant destinations. Keep exact matches separate from similar alternatives; a source-product row alone does not prove a price comparison succeeded. Missing prices or images stay unknown. Prices can change; taxes, delivery, size, condition and stock must be checked on the retailer page. Some links use disclosed affiliate redirects. Remode does not accept payments, place orders or guarantee checkout compatibility.
Only start or change a Watch after an explicit user request. Restock monitoring applies when the supplied product is explicitly out of stock. Watch updates are available through get_watch_updates; automatic delivery inside an assistant depends on that host’s integration.
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_fashion_by_description","arguments":{"query":"black leather ankle boots","region":"US","max_price":250,"max_results":5}}}Privacy and support
Submit only the image, link or shopping description needed for the request. Remode processes these inputs and uses search and commerce providers to retrieve results. Watch authorization grants access to the linked account’s Watch state. Never send payment card data or credentials in tool arguments. See the privacy policy for processing, retention, account deletion and data rights.