SearchShop AI

by nathangrotticelli · remote · no sign-in to list tools · v1.0.0 · published by GitHub user nathangrotticelli

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

Changes · 5

Compare Registry entry

11 tools: 5 change things and 6 only read.

Scanned Oct 21, 2026

Deletes or cancels0Claude Code: deny
Can't be undone0Claude Code: ask
Changes things5Claude Code: ask: see these tools
Only reads6Claude Code: allow: see these tools

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http searchshopai https://searchshopai-mcp.fly.dev/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn

Warnshop
The server marks "shop" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The description's first verb is "start": a word for a change.
What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

11 tools

Changes things 5Creates or changes something that can be changed back.Claude Code: ask

create_checkoutCreate a checkout URL for one or more products.No findings
Why it is in this group
- The name "create_checkout" says "create": a word for a change.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
shopStart here for any shopping request.1 finding
Why it is in this group
- The description's first verb is "start": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "shop" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The description's first verb is "start": a word for a change.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
skincare_cartCreate a buyable shopping cart with a real checkout URL.No findings
Why it is in this group
- The description's first verb is "create": a word for a change.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
skincare_recommend(Deprecated: use 'recommend' instead.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
(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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
skincare_report_issueReport when a tool result was unhelpful, incomplete, or wrong.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: false

Only reads 6Looks things up and changes nothing.Claude Code: allow

compare_productsCompare two or more products side by side.No findings
Why it is in this group
- The name "compare_products" says "compare": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
get_productGet full details for a specific product by SKU or title.No findings
Why it is in this group
- The name "get_product" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
get_research_noteGet the summary and URL of a specific SearchShopAI Research Note by its slug (returned by search_research_notes).No findings
Why it is in this group
- The name "get_research_note" says "get": a word for reading.
Description, as the server wrote it
Get the summary and URL of a specific SearchShopAI Research Note by its slug (returned by search_research_notes).
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
recommendGet a personalized product recommendation with domain-expert scoring.No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
search_productsBrowse and search the product catalog.No findings
Why it is in this group
- The name "search_products" says "search": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
search_research_notesSearch SearchShopAI's Research Notes blog — data studies, playbooks, and field notes on agentic commerce (AI attribution, MCP, AI catalog accuracy, ChatGPT ads).No findings
Why it is in this group
- The name "search_research_notes" says "search": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http searchshopai https://searchshopai-mcp.fly.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__searchshopai__recommend",
      "mcp__searchshopai__search_research_notes",
      "mcp__searchshopai__get_research_note",
      "mcp__searchshopai__search_products",
      "mcp__searchshopai__get_product",
      "mcp__searchshopai__compare_products"
    ],
    "ask": [
      "mcp__searchshopai__shop",
      "mcp__searchshopai__skincare_recommend",
      "mcp__searchshopai__skincare_cart",
      "mcp__searchshopai__skincare_report_issue",
      "mcp__searchshopai__create_checkout"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as searchshopai. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.github.nathangrotticelli/searchshopai/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

5 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry · repository. Synced Oct 21, 2026, 18:42 UTC.

For agents: Markdown · JSON · report this listing