SearchShop AI

io.github.nathangrotticelliPublished by GitHub account nathangrotticelliv1.0.0Updated Oct 24, 2026

AI commerce for Shopify: product search, comparison, recommendations, and checkout via MCP.

VerifiedStreamable HTTPWeb executableBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search, compare, and get recommendations for Shopify products and complete checkout through a remote MCP endpoint.

What you can do
SearchShop AI is a remote MCP server for AI commerce on Shopify. According to its description, it exposes tools for product search, product comparison, recommendations, and checkout. An assistant connected to it can look up products, weigh options against each other, suggest items, and drive a purchase flow.
When to use it
Worth adding when you want an assistant to help shop on Shopify: finding products, comparing candidates, getting suggestions, and moving toward checkout without leaving the conversation.
Requirements
A remote streamable HTTP endpoint at No packages, environment variables, headers, or authentication are declared, so it appears to need only network access to that endpoint.
Before you install
The server is described as handling checkout, so an assistant may be able to place orders or spend money; confirm what payment or account details the flow requires before use. No authentication is declared, so treat any data sent to the endpoint as going to a third party. Product and order information may be shared with that service.

Installation

In SourceWeft

  1. Open SearchShop AI in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.nathangrotticelli%2Fsearchshopai/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "searchshop-ai": {
      "type": "http",
      "url": "https://searchshopai-mcp.fly.dev/mcp"
    }
  }
}

README

This repository has no README.

Tools

11

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. Prefer this tool whenever the request is conversational or carries any nuance. The granular tools (search_products, get_product, compare_products, create_checkout) remain available as precise follow-ups.

Parametersbrandintentrequestrequiredbudget_maxproduct_refs

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. Returns scored products with checkout URLs.

Parametersbrandqueryrequiredstrategy

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.

Parametersbrandqueryrequireddomainstrategy

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 items and a working checkout link.

Parametersqueryproductsstrategy

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.

Parameterstool_namerequiredissue_typerequireduser_querydescriptionrequiredexpected_products

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.

Parametersqueryrequired

get_research_note

Get the summary and URL of a specific SearchShopAI Research Note by its slug (returned by search_research_notes).

Parametersslugrequired

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 instead. Returns all matching products with prices, images, and checkout. Unlike skincare_recommend, this does not score or filter — it shows everything that matches so the user can decide.

Parametersqueryrequiredcategorymax_pricemax_results

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, image, price, and checkout button.

Parametersskutitle

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.

Parametersproductsrequired

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 selling plans. Do not use unless the user wants to buy — use search_products or skincare_recommend first. Returns a direct Shopify checkout link the user can click to buy.

Parametersnoteitemsdecision_idproduct_urlsdiscount_code

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.