io.github.sepehr071/shopino-mcp

What it mainly works on, as our AI model read its tool descriptions: accounts and data in outside web services.

None of its 14 tools are described as changing anything.

• sh_searchreads or searches

  “Search products across all shops by keyword: price to pay, discount, stock, selling shop.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  13 inputs, 1 required

  • querystringrequired“Keyword, Persian works best, e.g.”
  • sortstring“Order; cheapest / most_expensive use the price to pay.”
  • in_stock_onlyboolean“Only products in stock now.”
  • discounted_onlyboolean“Only discounted products.”
  • min_priceinteger or null“Minimum price to pay in Toman, e.g.”
  • max_priceinteger or null“Maximum price to pay in Toman, e.g.”
  • category_idinteger or null“Category id from sh_categories, e.g.”
  • shop_idinteger or null“One shop's id (sh_shops), e.g.”
  • size_systemstring or null“Size system for `sizes` (values: sh_filters); freesize = only free-size items.”
  • sizesarray or null“Sizes in size_system (any of them), e.g.”
  • citystring or null“Same-day courier city, e.g.”
  • cursorstring or null“next_cursor of the previous reply (keep the other arguments the same).”
  • limitinteger“Products per page.”
• sh_find_cheapestreads or searches

  “Find the cheapest in-stock products for a keyword across all shops, one flat list sorted by price to pay.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  6 inputs, 1 required

  • querystringrequired“Keyword, Persian works best, e.g.”
  • category_idinteger or null“Category id from sh_categories, e.g.”
  • citystring or null“Same-day courier city, e.g.”
  • match_all_wordsboolean“Keep only products whose title or shop name has every query word.”
  • scaninteger“Max results to scan, cheapest first.”
  • limitinteger“Max offers to return.”
• sh_browsereads or searches

  “List products of a category, shop, tag or curated listing, with sort, price range and filters.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  15 inputs

  • category_idinteger or null“Category id from sh_categories, e.g.”
  • shop_idinteger or null“One shop's id (sh_shops), e.g.”
  • tagstring or null“Tag slug from sh_product `tags`, e.g.”
  • listingstring or null“Listing slug from sh_campaign tabs, e.g.”
  • sortstring“Order; cheapest / most_expensive use the price to pay.”
  • in_stock_onlyboolean“Only products in stock now.”
  • discounted_onlyboolean“Only discounted products.”
  • min_priceinteger or null“Minimum price to pay in Toman, e.g.”
  • max_priceinteger or null“Maximum price to pay in Toman, e.g.”
  • size_systemstring or null“Size system for `sizes` (values: sh_filters); freesize = only free-size items.”
  • sizesarray or null“Sizes in size_system (any of them), e.g.”
  • brand_idinteger or null“Watch brand id from sh_brands(shop_id=...), e.g.”
  • citystring or null“Same-day courier city, e.g.”
  • cursorstring or null“next_cursor of the previous reply (keep the other arguments the same).”
  • limitinteger“Products per page (a tag gives 16).”
• sh_filtersreads or searches

  “List the filter values sh_search / sh_browse accept: size systems and sizes, sorts, courier cities, and (with category_id) a category's sub-categories.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input

  • category_idinteger or null“Category id (sh_categories): adds its sub-categories.”
• sh_categoriesreads or searches

  “List the category tree with ids, URL paths and levels, plus total product and shop counts.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs

  • querystring or null“Filter on Persian name or English slug path, any level, e.g.”
  • max_levelinteger“Deepest level without a query (1 = the 14 top categories).”
• sh_brandsreads or searches

  “Without shop_id: featured official brand shops (browse one with sh_browse(shop_id=...)).”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input

  • shop_idinteger or null“Watch shop id, e.g.”
• sh_dealsreads or searches

  “List today's home-page deals (flash sale with end time, best sellers, themed rows), biggest discount first, plus running campaigns and shop discount codes.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input

  • limitinteger“Max deals to return.”
• sh_campaignreads or searches

  “Open a campaign or landing page: its product rows (with prices) and tabs.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs, 1 required

  • slugstringrequired“Slug from sh_deals campaigns, e.g.”
  • per_rowinteger“Products per row.”
• sh_productreads or searches

  “Get one product's full record: price, every color / size variant with its own price and stock, size guide, description, tags, the selling shop with trust signals, and the shop-site link.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs, 1 required

  • product_idintegerrequired“Product id from sh_search / sh_browse, e.g.”
  • full_textboolean“Return size guide and description uncut.”
• sh_similarreads or searches

  “Find products like this one at other shops (itself left out).”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  5 inputs, 1 required

  • product_idintegerrequired“Product id from sh_search / sh_browse, e.g.”
  • kindstring“visual = photo-alike products from all shops (to find the same item cheaper); similar = Shopino's 10 related products.”
  • sortstring“relevance (as returned) or cheapest first.”
  • in_stock_onlyboolean“Only products in stock now.”
  • limitinteger“Max products to return.”
• sh_blog_searchreads or searches

  “Search the style blog (guides and model galleries), newest first; no query = latest posts.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs

  • querystring or null“Topic, Persian, e.g.”
  • pageinteger“Page number, from 1 (3 posts per page).”
• sh_blog_postreads or searches

  “Read one blog post as plain text, with its category id for sh_browse (after sh_blog_search).”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs, 1 required

  • slugstringrequired“Post slug from sh_blog_search, e.g.”
  • max_charsinteger“Cut text after this many characters; up to 20000 for long posts.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.