MCP Server
Neonjelly
io.neonjelly/mcp
What this MCP does
Analyzes Shopify stores, products, apps, traffic, competitors, catalog changes, market cohorts and outreach contacts across a large store dataset.
Capabilities
Tools
60
tools
assortment_watch
Assortment watch
List new and removed SKUs plus bestseller enter/exit. Filter by storeDomain or productType when the user names a shop or category.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Assortment rows. Max 50.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'storeDomain': {'type': 'string', 'description': 'Limit to one merchant hostname. Example: gymshark.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
brief_market
Brief a market
Return a one-page TAM brief: vertical size, geos, movers, and an optional filtered cohort from 1.37M stores. Pass a vertical; quote catalog counts only â do not invent TAM.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}, 'minVisits': {'type': 'number', 'description': 'Minimum monthly visits. Example: 10000'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
change_tracker
Change board
Return a full change board: unified feed, all 8 product change types, 5 store change types, and Signals SKU changes if watched. Prefer this over calling each change tool separately.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 80, 'minimum': 1, 'description': 'SKU rows. Max 80.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'domain': {'type': 'string', 'description': 'Optional store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
cohort_tam
Cohort TAM
Roll a filtered store cohort into a groupBy table (country, vertical, industry, category). This is not the unfiltered get_countries TAM â use that when no filters apply.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'groupBy': {'enum': ['country', 'vertical', 'industry', 'category'], 'type': 'string', 'description': 'Roll rows into a breakdown table instead of store cards.'}, 'category': {'type': 'string', 'description': 'Store category label from the catalog.'}, 'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}, 'minVisits': {'type': 'number', 'description': 'Minimum monthly visits. Example: 10000'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}, 'groupMetric': {'enum': ['mean', 'median', 'max', 'min'], 'type': 'string', 'description': 'How to aggregate visits/revenue when groupBy is set.'}, 'isDropshipper': {'type': 'boolean', 'description': 'If true, only stores the catalog flags as dropship.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
compare_stacks
Compare app stacks
Compare 2â8 store app stacks: shared vs exclusive apps, tagged by role (email, support, reviews, subs, ads). Pass hostnames, not brand names.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domains'], 'properties': {'domains': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 8, 'minItems': 2, 'description': '2â\x80\x938 store hostnames. Example: ["gymshark.com","allbirds.com"]'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
compare_stores
Compare store cards
Compare 2â8 store cards side by side (traffic, revenue band, apps, rating). Missing domains land in notFound â do not invent the missing rows.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domains'], 'properties': {'domains': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 8, 'minItems': 2, 'description': '2â\x80\x938 store hostnames. Example: ["gymshark.com","allbirds.com"]'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
competitor_moves
Competitor moves
List catalog store and SKU changes plus vertical movers for one competitor domain. Ads and daily units need a paid Signals watch â do not offer create_signal on trial.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
create_signal
Watch a store (paid)
Paid plans only (trial 403). Create a Signals watch on a competitor domain for ads, units, inventory, and social. Tight watch cap; meters the key. No probe, no scrape.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}, 'autoTrack': {'enum': ['bestsellers', 'none'], 'type': 'string', 'description': 'Signals auto-track mode. bestsellers watches top SKUs; none is the card only.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
diligence_pack
Diligence pack
Build an IC memo for one domain: card, growth, traffic, stack roles, bestsellers, changes, and contacts. Includes Signals stats only if that domain is already watched.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
find_outreach
Outreach store list
Filter the 1.37M-store catalog, hydrate each row, and keep stores that have an email or Instagram. Caps at 10 (each costs a call) â country is a filter, not a login region.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max stores to hydrate. Caps at 10 â\x80\x94 each costs a catalog call.'}, 'appSlug': {'type': 'string', 'description': 'Shopify app slug. Example: klaviyo-email-marketing'}, 'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}, 'minVisits': {'type': 'number', 'description': 'Minimum monthly visits. Example: 10000'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
find_peers
Find peer stores
Find stores in the same vertical, country, and visit band as a target domain, then compare cards. Call resolve_store first if you only have a brand name.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 2, 'description': 'How many peer stores to return. Default 8, max 25.'}, 'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_analytics_overview
Catalog coverage
Return catalog coverage: store/SKU counts, averages, top verticals and countries. Quote these snapshot figures only â do not invent traffic totals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_app
Get one app
Return one Shopify app plus an install-base sample. Copy slug from search_apps, then get_app_stores for the merchant list.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Shopify App Store slug. Example: klaviyo-email-marketing'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_app_stores
Stores running an app
List merchants observed running a Shopify app, sorted by visits. Use for âwho uses Klaviyo?â store lists â country filters live on search_stores, not here.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Shopify App Store slug. Example: klaviyo-email-marketing'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_changes
Unified change feed
Return the unified store + product movement feed. Prefer change_tracker when the user wants every change type on one board.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'domain': {'type': 'string', 'description': 'Optional store hostname without protocol. Example: gruntstyle.com'}, 'entity': {'enum': ['product', 'store'], 'type': 'string', 'description': 'Limit the unified change feed to products or stores.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_contacts
Store contacts
Return emails, social URLs, and ESP/support app tells for one store. No phone or owner names in this catalog â pass domain or q.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'domain': {'type': 'string', 'description': 'Optional store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_countries
Country TAM
Return unfiltered geo TAM (store counts by country). Pass vertical to slice one market; a filtered cohort belongs on search_stores groupBy=country.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_examples
Example playbooks
Same playbook map as list_playbooks (VC, competitor, dropship, outreach). Prefer list_playbooks on new sessions.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_movers
Growing / shrinking stores
List stores growing or shrinking on visits or modeled revenue. Defaults: metric/direction any, minPct 5. Quote catalog movers only.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'metric': {'enum': ['visits', 'revenue', 'any'], 'type': 'string', 'description': 'Mover metric. Default any.'}, 'minPct': {'type': 'number', 'description': 'Minimum percent move for movers. Default 5.'}, 'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}, 'direction': {'enum': ['up', 'down', 'any'], 'type': 'string', 'description': 'Mover direction. Default any.'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_product
Get one SKU
Return one SKU by store domain plus Shopify handle. Use get_store_products or product_search when you do not yet have the handle.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain', 'handle'], 'properties': {'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}, 'handle': {'type': 'string', 'minLength': 1, 'description': 'Shopify product handle from the PDP URL. Example: classic-hoodie'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_product_changes
SKU movements
List price, new, removed, position, and bestseller SKU movements. Filter by storeDomain or productType; default noise floor is minPriceChangePct.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}, 'changeType': {'enum': ['price_increase', 'price_decrease', 'new_product', 'removed_product', 'position_up', 'position_down', 'best_seller_entered', 'best_seller_exited'], 'type': 'string', 'description': 'One SKU movement type.'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'storeDomain': {'type': 'string', 'description': 'Limit to one merchant hostname. Example: gymshark.com'}, 'minPriceChangePct': {'type': 'number', 'description': 'Minimum absolute price-change percent. Default 10.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_product_research
Product-idea report
Return the saturation report for one product idea. Copy id from search_product_ideas or niche_research â do not invent seller counts.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Product-idea id from search_product_ideas or niche_research.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal
Signal card (paid)
Paid plans only (trial 403). Return one signal card. id is a Mongo id or a domain already on Signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_ads
Signal ads (paid)
Paid plans only (trial 403). Return the ad library or a slice (overview default). No probe â domain must already be on Signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}, 'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Lookback window in days for ad slices. Max 365.'}, 'slice': {'enum': ['overview', 'ads', 'correlation', 'revenue', 'product-impact', 'timeline', 'events'], 'type': 'string', 'description': 'Ad library slice. Default overview.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_apps
Signal apps (paid)
Paid plans only (trial 403). Return apps observed on a tracked store. Set changes=true for app change history.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}, 'changes': {'type': 'boolean', 'description': 'If true, return app change history instead of the current stack.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_insights
Signal insights (paid)
Paid plans only (trial 403). Return the insight feed for one watched domain. Prefer this over list_signal_insights.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_inventory
Signal inventory (paid)
Paid plans only (trial 403). Return the stock timeline for a watched store. Domain must already be on Signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_product_changes
Signal SKU changes (paid)
Paid plans only (trial 403). Return product movements on a tracked store. Catalog-wide SKU moves use get_product_changes.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_sales
Signal daily units (paid)
Paid plans only (trial 403). Return daily units and variants. Needs â¥2 inventory snapshots on the watch â do not invent unit counts.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}, 'to': {'type': 'string', 'description': 'Inclusive end date YYYY-MM-DD.'}, 'from': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_social
Signal social (paid)
Paid plans only (trial 403). Return follower snapshots for a watched store. Domain must already be on Signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_signal_stats
Signal stats (paid)
Paid plans only (trial 403). Return totals plus store profile for a signal. Domain must already be on Signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Signal Mongo id or a domain already on Signals. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_store
Get store card
Return one merchant card: traffic, modeled revenue, rating, apps, and socials. Call resolve_store first if you only have a brand name â missing domains stay not_found.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_store_apps
Store app stack
List Shopify apps detected on one merchant. Use compare_stacks when the user wants shared vs exclusive apps across several domains.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_store_changes
Store observation diffs
List observation diffs for one store: revenue, visits, products, rating, apps. For a mixed product+store board, prefer change_tracker.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}, 'changeType': {'enum': ['revenue_change', 'visits_change', 'products_change', 'rating_change', 'apps_change'], 'type': 'string', 'description': 'One store observation-diff type.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_store_history
Store history
Return daily snapshots: visits, revenue band, rating, and product counts, up to 365 days. Use for growth charts after get_store.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'limit': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Daily snapshot days. Max 365.'}, 'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_store_products
Store SKUs
List SKUs for one merchant with price, vendor, type, and bestseller filters. Prefer this over global search_products when you already have a domain.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'tag': {'type': 'string', 'description': 'Shopify product tag.'}, 'sort': {'enum': ['price', 'position', 'scraped'], 'type': 'string', 'description': 'SKU sort: price, merchandising position, or last scrape.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Default desc.'}, 'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}, 'vendor': {'type': 'string', 'description': 'Product vendor / supplier name as listed on the storefront.'}, 'priceMax': {'type': 'number', 'description': 'Maximum listed price in store currency.'}, 'priceMin': {'type': 'number', 'description': 'Minimum listed price in store currency.'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'isBestSeller': {'type': 'boolean', 'description': 'If true, only SKUs currently flagged as bestsellers.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_store_traffic
Store traffic
Return monthly visits and channel mix for one store. Use after get_store when the user asks how traffic is trending.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'limit': {'type': 'integer', 'maximum': 120, 'minimum': 1, 'description': 'Monthly traffic points. Max 120.'}, 'domain': {'type': 'string', 'minLength': 1, 'description': 'Store hostname without protocol. Example: gruntstyle.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_upstream_health
Catalog health
Return catalog health JSON and whether auth is required. Use when a lookup fails unexpectedly â not for store research.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
get_verticals
Vertical market size
Return market size by vertical (store counts and averages). Pass countryCode to slice one geo â for a filtered cohort, use search_stores with groupBy=vertical.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
list_playbooks
List playbooks
List composed-tool playbooks by job: store lists, VC, competitor, dropship, outreach, merch. Start here when the user has not named a tool â then call the playbook's first tool.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
list_product_sellers
Stores selling an idea
List stores selling a product idea, sorted by traffic or price. Copy id from search_product_ideas â this is who-sells-this, not a single merchant SKU list.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Product-idea id from search_product_ideas or niche_research.'}, 'page': {'type': 'integer', 'minimum': 1, 'description': '1-based page. Default 1.'}, 'sort': {'enum': ['traffic', 'price'], 'type': 'string', 'description': 'Seller list sort: store traffic or SKU price.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Sellers to return. Max 100.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
list_signal_insights
Account insight feed (paid)
Paid plans only (trial 403). Account-wide insight feed â often empty unless the key owns watches. Prefer get_signal_insights with a domain already on Signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
list_signals
List Signals watches (paid)
Paid plans only (trial 403). List Signals watches stored on this Neonjelly key. Then GET a domain that is already on Signals â do not advertise this on trial.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
niche_research
Niche saturation
Run semantic product-idea search plus a saturation report and the stores that sell the top hit. q is a product name or category, not a domain â quote seller count and the UNTAPPEDâSATURATED verdict.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'Product name or category, not a domain. Example: neck fan or yoga mat'}, 'limit': {'type': 'integer', 'maximum': 40, 'minimum': 1, 'description': 'Product ideas to return. Max 40.'}, 'market': {'enum': ['UNTAPPED', 'LOW COMPETITION', 'COMPETITIVE', 'SATURATED'], 'type': 'string', 'description': 'Keep ideas with this saturation verdict only.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
overlap_vendors
Vendor overlap
Find product-vendor overlap and the average price gap between two stores. Use after compare_stacks when you need shared suppliers, not shared apps.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domainA', 'domainB'], 'properties': {'limit': {'type': 'integer', 'maximum': 80, 'minimum': 5, 'description': 'Shared-vendor rows to return. Min 5, max 80.'}, 'domainA': {'type': 'string', 'minLength': 1, 'description': 'First store hostname. Example: gymshark.com'}, 'domainB': {'type': 'string', 'minLength': 1, 'description': 'Second store hostname. Example: allbirds.com'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
price_watch
Price watch
List price decreases and increases across stores or one merchant. Default minPriceChangePct is 10 â raise it to cut noise.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Change rows. Max 60.'}, 'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'storeDomain': {'type': 'string', 'description': 'Limit to one merchant hostname. Example: gymshark.com'}, 'minPriceChangePct': {'type': 'number', 'description': 'Minimum absolute price-change percent. Default 10.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
product_intel
SKU memo
Build one SKU memo: card, discount vs compare-at, store, SKU change history, and store bestsellers. Pass domain+handle, or q to resolve first.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'domain': {'type': 'string', 'description': 'Optional store hostname without protocol. Example: gruntstyle.com'}, 'handle': {'type': 'string', 'description': 'Optional Shopify product handle. Example: classic-hoodie'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
product_search
Search SKUs + facets
Search cross-store SKUs and return rows plus facets (vendors, types, stores, price band). At least one filter is required. For saturation / who-sells-this-idea, use niche_research.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'tag': {'type': 'string', 'description': 'Shopify product tag.'}, 'sort': {'enum': ['price', 'position', 'scraped'], 'type': 'string', 'description': 'SKU sort: price, merchandising position, or last scrape.'}, 'limit': {'type': 'integer', 'maximum': 80, 'minimum': 1, 'description': 'SKU rows. Max 80.'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Default desc.'}, 'vendor': {'type': 'string', 'description': 'Product vendor / supplier name as listed on the storefront.'}, 'priceMax': {'type': 'number', 'description': 'Maximum listed price in store currency.'}, 'priceMin': {'type': 'number', 'description': 'Minimum listed price in store currency.'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'storeDomain': {'type': 'string', 'description': 'Limit to one merchant hostname. Example: gymshark.com'}, 'isBestSeller': {'type': 'boolean', 'description': 'If true, only SKUs currently flagged as bestsellers.'}, 'storeVertical': {'type': 'string', 'description': 'Vertical of the selling store. Example: Apparel'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
resolve_store
Resolve a store
Resolve a brand name or URL against 1.37M Shopify storefronts and return up to 5 candidates. On a single hit, also return the full store card â call this before inventing a domain; missing stores stay not_found.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 1, 'description': 'Brand, product, or free-text query. Example: gymshark or neck fan'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
screen_dropship
Screen dropship stores
List dropship-flagged stores in a vertical/geo plus their cheapest SKUs. Country is a filter, not a login region â quote the catalog flag, do not invent supplier names.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'How many dropship-flagged stores to screen. Max 12.'}, 'priceMax': {'type': 'number', 'description': 'Maximum listed price in store currency.'}, 'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}, 'minVisits': {'type': 'number', 'description': 'Minimum monthly visits. Example: 10000'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
search_apps
Search Shopify apps
Search the Shopify App Store catalog by name, category, pricing, or rating. Follow a slug with get_app_stores to see which merchants run it.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'sort': {'enum': ['rating', 'reviews', 'name'], 'type': 'string', 'description': 'App catalog sort. Default rating.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Default desc.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}, 'category': {'type': 'string', 'description': 'Store category label from the catalog.'}, 'minRating': {'type': 'number', 'description': 'Minimum store or app rating 0â\x80\x935. Example: 4.2'}, 'pricingType': {'type': 'string', 'description': 'App Store pricing type filter. Example: free or subscription'}, 'builtForShopify': {'type': 'boolean', 'description': 'If true, only Built for Shopify apps.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
search_product_ideas
Search product ideas
Search product names/categories and return ideas with seller count, price, and UNTAPPEDâSATURATED verdict â not one-store listings. Prefer niche_research when the user asks âis this saturated?â
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'Product name or category, not a domain. Example: neck fan or yoga mat'}, 'page': {'type': 'integer', 'minimum': 1, 'description': '1-based page. Default 1.'}, 'market': {'type': 'string', 'description': 'Comma verdicts: UNTAPPED,LOW COMPETITION,COMPETITIVE,SATURATED'}, 'region': {'type': 'string', 'description': 'Optional region label for product-idea search.'}, 'priceMax': {'type': 'number', 'description': 'Maximum listed price in store currency.'}, 'priceMin': {'type': 'number', 'description': 'Minimum listed price in store currency.'}, 'trending': {'type': 'boolean', 'description': 'If true, only ideas marked trending.'}, 'countries': {'type': 'string', 'description': 'ISO-2 country list, comma-separated. Example: US,GB,CA'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
search_products
Search catalog SKUs
Search SKUs across the 368.9M-product catalog. At least one filter is required. For saturation or who-sells-this-idea, use niche_research.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'tag': {'type': 'string', 'description': 'Shopify product tag.'}, 'sort': {'enum': ['price', 'position', 'scraped'], 'type': 'string', 'description': 'SKU sort: price, merchandising position, or last scrape.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Default desc.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}, 'vendor': {'type': 'string', 'description': 'Product vendor / supplier name as listed on the storefront.'}, 'priceMax': {'type': 'number', 'description': 'Maximum listed price in store currency.'}, 'priceMin': {'type': 'number', 'description': 'Minimum listed price in store currency.'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'storeDomain': {'type': 'string', 'description': 'Limit to one merchant hostname. Example: gymshark.com'}, 'isBestSeller': {'type': 'boolean', 'description': 'If true, only SKUs currently flagged as bestsellers.'}, 'storeVertical': {'type': 'string', 'description': 'Vertical of the selling store. Example: Apparel'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
search_stores
Search store lists
Filter 1.37M Shopify stores into a list (emails/socials live on the card) or roll them up with groupBy. Without groupBy you get store cards; with groupBy you get breakdown rows, not stores. Country is a filter, not a login region.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'sort': {'enum': ['visits', 'revenue', 'rating', 'domain', 'stores'], 'type': 'string', 'description': 'Store list sort. Use stores when groupBy is set.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size. Default 20, max 100.'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Default desc.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many rows. Pair with limit to page.'}, 'appSlug': {'type': 'string', 'description': 'Shopify app slug. Example: klaviyo-email-marketing'}, 'groupBy': {'enum': ['country', 'vertical', 'industry', 'category'], 'type': 'string', 'description': 'Roll rows into a breakdown table instead of store cards.'}, 'category': {'type': 'string', 'description': 'Store category label from the catalog.'}, 'groupBy2': {'enum': ['country', 'vertical', 'industry', 'category'], 'type': 'string', 'description': 'Second breakdown axis. Same values as groupBy. Example: country'}, 'industry': {'type': 'string', 'description': 'Store industry label from the catalog.'}, 'vertical': {'type': 'string', 'description': 'Catalog vertical. Example: Skincare, Apparel, Fashion'}, 'maxVisits': {'type': 'number', 'description': 'Maximum monthly visits. Example: 500000'}, 'minRating': {'type': 'number', 'description': 'Minimum store or app rating 0â\x80\x935. Example: 4.2'}, 'minVisits': {'type': 'number', 'description': 'Minimum monthly visits. Example: 10000'}, 'maxRevenue': {'type': 'number', 'description': 'Maximum modeled monthly revenue in USD. Example: 1000000'}, 'minRevenue': {'type': 'number', 'description': 'Minimum modeled monthly revenue in USD. Example: 50000'}, 'countryCode': {'type': 'string', 'description': 'ISO-3166 alpha-2 country filter, not a login region. Example: US, GB, IN'}, 'groupMetric': {'enum': ['mean', 'median', 'max', 'min'], 'type': 'string', 'description': 'How to aggregate visits/revenue when groupBy is set.'}, 'isDropshipper': {'type': 'boolean', 'description': 'If true, only stores the catalog flags as dropship.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
source_map
Map SKU sources
Group a SKU search by vendor: store count and price min/max across the catalog. Use for sourcing or arbitrage after niche_research names the product.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional free-text query. Example: hoodie or gymshark'}, 'limit': {'type': 'integer', 'maximum': 80, 'minimum': 5, 'description': 'Vendor groups to return. Min 5, max 80.'}, 'vendor': {'type': 'string', 'description': 'Product vendor / supplier name as listed on the storefront.'}, 'priceMax': {'type': 'number', 'description': 'Maximum listed price in store currency.'}, 'productType': {'type': 'string', 'description': 'Shopify product type. Example: T-Shirt or Hoodie'}, 'storeVertical': {'type': 'string', 'description': 'Vertical of the selling store. Example: Apparel'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
suggest_product_ideas
Suggest product ideas
Autocomplete product-idea names as the user types. Follow with search_product_ideas or niche_research on the chosen row.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 1, 'description': 'Brand, product, or free-text query. Example: gymshark or neck fan'}, 'limit': {'type': 'integer', 'maximum': 15, 'minimum': 1, 'description': 'Autocomplete rows. Max 15.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
trending_product_ideas
Trending product ideas
List product ideas the catalog marks as heating up. Pair a hit with get_product_research and list_product_sellers â do not invent trend scores.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
upgrade
Get checkout URL
Return the paid upgrade URL when trial expired, daily quota is 0, or Signals is blocked. Does not count against quota. Always show the returned URL â never invent a checkout link.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
whoami
Check quota
Return this key's plan, used today, remaining quota, rate limit, and expiry. Does not count against daily quota â call first when the user asks âwhat's my quota?â If remaining is 0 or trial expired, call upgrade and open the URL.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
winning_skus
Winning SKUs
List bestsellers, â¥10% markdowns, and new products for a vertical or one store. Require storeVertical or storeDomain â do not call empty.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'since': {'type': 'string', 'description': 'Inclusive start date YYYY-MM-DD. Example: 2026-08-01'}, 'storeDomain': {'type': 'string', 'description': 'Limit to one merchant hostname. Example: gymshark.com'}, 'storeVertical': {'type': 'string', 'description': 'Vertical of the selling store. Example: Apparel'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'type': 'string', 'description': 'Set when the call failed. Example: not_found'}, 'message': {'type': 'string', 'description': 'Human-readable error or hint'}}, 'description': 'JSON object this tool returns. Catalog tools wrap upstream rows; whoami/upgrade return quota fields.', 'additionalProperties': True}
History
Recent tool changes
Added
list_signal_insights
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_insights
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_product_changes
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_apps
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_ads
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_social
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_inventory
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_sales
Sept. 17, 2026, 12:53 p.m.
Added
get_signal_stats
Sept. 17, 2026, 12:53 p.m.
Added
get_signal
Sept. 17, 2026, 12:53 p.m.
Added
list_signals
Sept. 17, 2026, 12:53 p.m.
Added
create_signal
Sept. 17, 2026, 12:53 p.m.
Added
get_movers
Sept. 17, 2026, 12:53 p.m.
Added
get_countries
Sept. 17, 2026, 12:53 p.m.
Added
get_verticals
Sept. 17, 2026, 12:53 p.m.
Added
get_analytics_overview
Sept. 17, 2026, 12:53 p.m.
Added
get_app_stores
Sept. 17, 2026, 12:53 p.m.
Added
get_app
Sept. 17, 2026, 12:53 p.m.
Added
search_apps
Sept. 17, 2026, 12:53 p.m.
Added
get_changes
Sept. 17, 2026, 12:53 p.m.
Added
get_product_changes
Sept. 17, 2026, 12:53 p.m.
Added
get_product
Sept. 17, 2026, 12:53 p.m.
Added
search_products
Sept. 17, 2026, 12:53 p.m.
Added
get_store_changes
Sept. 17, 2026, 12:53 p.m.
Added
get_store_history
Sept. 17, 2026, 12:53 p.m.
Added
get_store_apps
Sept. 17, 2026, 12:53 p.m.
Added
get_store_products
Sept. 17, 2026, 12:53 p.m.
Added
get_store_traffic
Sept. 17, 2026, 12:53 p.m.
Added
compare_stores
Sept. 17, 2026, 12:53 p.m.
Added
get_store
Sept. 17, 2026, 12:53 p.m.
Discover
Similar MCP servers
Ask AI
com.ask-ai-data-connector/ask-ai
Answers questions about connected e-commerce data from Shopify, Klaviyo, GA4, Triple Whale, and other sources, covering sales, ma…
wildberries-agent-integration
io.github.BearsCLOUD/wildberries-agent-integration
Analyzes Wildberries seller sales, inventory, regional performance, competition, SEO, replenishment, weather relationships, and u…
AMZScout Skill + MCP
io.github.amzscout-corp/amzscout-skill-mcp
Provides Amazon product, niche, brand, keyword, sales, pricing, competition, and PPC research data.
signals
com.rivalsweeper/signals
Provides paid competitive intelligence on ecommerce brands, including prices, promotions, links, competitors, stock history, and …
Shopify Change Intelligence
io.github.contentforge-press/shopify-intel
Monitors public Shopify stores for product, price, inventory, and competitive landscape changes.
Decision Intelligence
com.timzinin.api/decision-intelligence
Analyzes supplied app reviews, advertising evidence, and US retail data to identify regressions, ad changes, pricing, availabilit…
KDP Niche Research
io.github.simul813/kdp-niche-research
Researches Kindle publishing niches using demand, competition, ranking, revenue, pricing, and review metrics.
Eevy
ai.eevy/mcp
Supports Shopify conversion-rate optimization through analytics, experimentation, content authoring, and lift measurement.