io.github.nathangrotticelli/searchshopai · v1.0.0 · ecommerce
SearchShop AI is healthy: it completed an MCP handshake in 686 ms and exposes 11 tools.
AI commerce for Shopify: product search, comparison, recommendations, and checkout via MCP.
Endpoint: https://searchshopai-mcp.fly.dev/mcp (streamable-http)
Repository · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 11 |
| Latency | 686 ms |
| Last checked (UTC) | 2026-10-16T10:55:36.568Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-16T10:55:36.568Z | Healthy | 686 | |
| 2026-10-15T06:10:35.767Z | Healthy | 2501 |
shop | Start here for any shopping request. Pass the shopper's COMPLETE request in their own words and this tool will understand it and route to the right capability (personalized recommendation, catalog search, product lookup, or comparison), preserving every qualifier — concerns, skin type, budget, brand |
skincare_recommend | (Deprecated: use 'recommend' instead. Works identically.) Get a personalized skincare recommendation with ingredient-aware scoring and routine building. Use when the user wants advice, has a skin concern, or asks what to buy. Do not use for browsing or listing products — use search_products instead. |
recommend | Get a personalized product recommendation with domain-expert scoring. Use when the user wants advice, has a concern, or asks what to buy. Returns scored products with checkout URLs. |
skincare_cart | Create a buyable shopping cart with a real checkout URL. Two modes: (1) Pass 'products' array with specific product names. (2) Pass 'query' string to auto-recommend and cart. Do not use for browsing or recommendations — use search_products or skincare_recommend first. Returns a widget with the cart |
skincare_report_issue | Report when a tool result was unhelpful, incomplete, or wrong. Call this whenever you override a recommendation, skip a cart result, or notice the engine output doesn't match what the user needs. Do not use proactively — only when you observe an actual issue. This helps improve the engine. |
search_research_notes | Search SearchShopAI's Research Notes blog — data studies, playbooks, and field notes on agentic commerce (AI attribution, MCP, AI catalog accuracy, ChatGPT ads). Returns matching articles with titles, summaries, and URLs. Use when asked what SearchShopAI has written or published about a topic. |
get_research_note | Get the summary and URL of a specific SearchShopAI Research Note by its slug (returned by search_research_notes). |
search_products | Browse and search the product catalog. Use when the user wants to see what's available, look up specific products, browse by category, compare options, or asks 'show me' / 'what do you have.' Do not use when the user needs personalized recommendations based on skin concerns — use skincare_recommend |
get_product | Get full details for a specific product by SKU or title. Use when the user asks about a specific product by name (e.g. 'tell me about MIRA', 'show me the serum'). Do not use for browsing or recommendations — use search_products or skincare_recommend. Returns a widget card with the product details, i |
compare_products | Compare two or more products side by side. Use when the user asks to compare, says 'X vs Y', or wants to decide between options. Do not use for single product lookup — use get_product instead. Returns structured comparison with shared attributes, differences, tradeoffs, and a decision hint. |
create_checkout | Create a checkout URL for one or more products. Pass variant IDs (items) and/or product URLs (product_urls). When a product URL is provided (e.g. https://laluer.com/products/mira), the tool resolves it to a variant ID automatically — no catalog import needed. Supports discount codes, cart notes, and |