StoreLeads MCP connector
Bearer TokenCRM & SalesMarketingAnalyticsConnect to StoreLeads MCP to discover, search, and analyze e-commerce stores and their technology stack from your AI workflows.
StoreLeads MCP connector
-
Install the SDK
Section titled “Install the SDK”Terminal window npm install @scalekit-sdk/nodeTerminal window pip install scalekit -
Set your credentials
Section titled “Set your credentials”Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret> -
Make your first call
Section titled “Make your first call”quickstart.ts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENV_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'storeleadsmcp'const identifier = 'user_123'// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'storeleadsmcp_get_platforms',toolInput: {},})console.log(result)quickstart.py import osfrom scalekit.client import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENV_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "storeleadsmcp"identifier = "user_123"# Make your first callresult = actions.execute_tool(tool_input={},tool_name="storeleadsmcp_get_platforms",connection_name=connection_name,identifier=identifier,)print(result)
What you can do
Section titled “What you can do”Connect this agent connector to let your agent:
- Search technologies, domains, apps — Search technologies used by e-commerce stores
- List historical datasets — List available historical domain snapshots
- Get technology, products for domain, product — Look up a single technology by name
- Domain detect, company to — Detect what e-commerce platform a domain is using
Tool list
Section titled “Tool list”Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.
storeleadsmcp_bulk_get_domains#Fetch multiple domains by name in a single request.3 params
Fetch multiple domains by name in a single request.
domainsarrayrequiredArray of domain names to look up (max 100)fieldsstringoptionalComma-separated fields to returnproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_company_to_domain#Map a company name to its e-commerce domain.2 params
Map a company name to its e-commerce domain.
namestringrequiredCompany name to look upproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_detect_domain#Detect what e-commerce platform a domain is using.2 params
Detect what e-commerce platform a domain is using.
namestringrequiredDomain name to detect (e.g. 'example.com')providerstringoptionalPlatform provider (default: "all")storeleadsmcp_get_app#Look up a single app by its token/slug. Returns installs, reviews, rating, vendor info, and more.3 params
Look up a single app by its token/slug. Returns installs, reviews, rating, vendor info, and more.
tokenstringrequiredApp token/slug identifierfieldsstringoptionalComma-separated fields to returnproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_get_app_reviews#Get reviews for a specific app.2 params
Get reviews for a specific app.
tokenstringrequiredApp token/slug identifierproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_get_domain#Look up a single e-commerce store domain by name. Returns platform, plan, estimated sales, apps, technologies, contact info, social stats, and more.3 params
Look up a single e-commerce store domain by name. Returns platform, plan, estimated sales, apps, technologies, contact info, social stats, and more.
namestringrequiredDomain name (e.g. 'example.com')fieldsstringoptionalComma-separated fields to returnproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_get_domain_by_id#Look up a domain by its internal numeric ID.3 params
Look up a domain by its internal numeric ID.
idnumberrequiredInternal domain IDfieldsstringoptionalComma-separated fields to returnproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_get_historical_domains#Get domains from a specific historical snapshot.4 params
Get domains from a specific historical snapshot.
labelstringrequiredHistorical snapshot label (from list_historical_datasets)pagenumberoptionalPage numberpage_sizenumberoptionalResults per pageproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_get_platforms#List all available e-commerce platforms/providers.1 param
List all available e-commerce platforms/providers.
providerstringoptionalPlatform provider (default: "all")storeleadsmcp_get_product#Get a specific product by its ID.2 params
Get a specific product by its ID.
idnumberrequiredProduct IDproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_get_products_for_domain#Get products listed on an e-commerce store domain.2 params
Get products listed on an e-commerce store domain.
namestringrequiredDomain name (e.g. 'example.com')providerstringoptionalPlatform provider (default: "all")storeleadsmcp_get_technology#Look up a single technology by name. Returns install count, description, categories, and vendor info.3 params
Look up a single technology by name. Returns install count, description, categories, and vendor info.
namestringrequiredTechnology name (e.g. 'Klaviyo')fieldsstringoptionalComma-separated fields to returnproviderstringoptionalPlatform provider (default: "all")storeleadsmcp_list_historical_datasets#List available historical domain snapshots.1 param
List available historical domain snapshots.
providerstringoptionalPlatform provider (default: "all")storeleadsmcp_search_apps#Search e-commerce apps across app stores (Shopify, BigCommerce, etc.). Filter by category, vendor, install count, review count, and more.7 params
Search e-commerce apps across app stores (Shopify, BigCommerce, etc.). Filter by category, vendor, install count, review count, and more.
fieldsstringoptionalComma-separated fields to returnfiltersobjectoptionalFilter object using f: prefix keys. Common filters:
- "f:p": platform (e.g. "shopify")
- "f:categories": app category
- "f:vendor": vendor name
- "f:vcc": vendor country code
- "f:as": app state ("Active"/"Inactive")
- "f:icmin"/"f:icmax": install count range
- "f:rcmin"/"f:rcmax": review count rangepagenumberoptionalPage numberpage_sizenumberoptionalResults per pageproviderstringoptionalPlatform provider (default: "all")qstringoptionalKeyword search querysortstringoptionalSort fields (e.g. '-installs')storeleadsmcp_search_domains#Search and filter e-commerce store domains. Supports filtering by country, category, technology, app, theme, estimated sales, product count, rank, employee count, social followers, and more. Providers include shopify, bigcommerce, woocommerce, squarespace, webflow, etc. Use provider "all" to search across all platforms.
IMPORTANT:
- Technology filters ("f:tech") require exact names. Use search_technologies first to get the exact name.
- App filters ("f:an") require the app ID in "platform.token" format (e.g. "shopify.klaviyo-email-marketing"). ALWAYS use search_apps first, then use the "id" field from the result as the "f:an" value. Do NOT use the app name or token alone.8 params
Search and filter e-commerce store domains. Supports filtering by country, category, technology, app, theme, estimated sales, product count, rank, employee count, social followers, and more. Providers include shopify, bigcommerce, woocommerce, squarespace, webflow, etc. Use provider "all" to search across all platforms. IMPORTANT: - Technology filters ("f:tech") require exact names. Use search_technologies first to get the exact name. - App filters ("f:an") require the app ID in "platform.token" format (e.g. "shopify.klaviyo-email-marketing"). ALWAYS use search_apps first, then use the "id" field from the result as the "f:an" value. Do NOT use the app name or token alone.
cursorstringoptionalPagination cursor from previous responsefieldsstringoptionalComma-separated fields to return (e.g. 'name,platform,estimated_sales,country_code')filtersobjectoptionalFilter object using f: prefix keys.
Location & language:
- "f:cc": country code (e.g. "US", "AU", "GB")
- "f:reg": region (e.g. "Europe", "Americas")
- "f:sreg": subregion (e.g. "Northern Europe")
- "f:lang": language code (e.g. "en", "de")
- "f:curr": currency code (e.g. "USD", "AUD", "EUR")
Platform & plan:
- "f:p": ecommerce platform (e.g. "shopify", "woocommerce")
- "f:plan": pricing plan (e.g. "Shopify Plus", "Professional")
- "f:ds": domain state ("Active", "Inactive", "Password Protected")
Apps & technologies:
- "f:an": app ID in "platform.token" format (e.g. "shopify.klaviyo-email-marketing"). IMPORTANT: use the "id" field from search_apps, NOT the app name.
- "f:tech": technology name (use search_technologies first to get the exact name)
- "f:app_installed_at": app ID to filter by install date (use with f:app_installed_at:min/max)
- "f:app_installed_at:min"/"f:app_installed_at:max": date range for app install (ISO format)
- "f:tech_installed_at": technology name to filter by install date (use with f:tech_installed_at:min/max)
- "f:tech_installed_at:min"/"f:tech_installed_at:max": date range for tech install (ISO format)
Store attributes:
- "f:cat": category (e.g. "/Apparel", "/Beauty & Fitness")
- "f:tn": theme name
- "f:features": store features (e.g. "Contact Page", "Returns Page", "Store Locator Page", "Has iOS App")
- "f:tags": tags (e.g. "Dropshipper", "Print on Demand", "Trending on TikTok")
Numeric ranges (use min/max suffixes):
- "f:ermin"/"f:ermax": estimated monthly sales in cents of USD (e.g. 4000000 = $40k/month)
- "f:pcmin"/"f:pcmax": product count range
- "f:rankmin"/"f:rankmax": rank range
- "f:empcmin"/"f:empcmax": employee count range
- "f:masmin"/"f:masmax": monthly app spend in cents of USD
Dates:
- "f:cratmin"/"f:cratmax": created at date range (ISO format)
Boolean operations — use ":op" suffix for multi-value filters:
- "or": match any value (e.g. "f:cc": "US,GB", "f:cc:op": "or")
- "and": match all values (default)
- "not": exclude matching valuespagenumberoptionalPage number (0-indexed)page_sizenumberoptionalResults per page (default: 50, max: 5000)providerstringoptionalPlatform provider (e.g. "shopify", "woocommerce", "bigcommerce", "all"). Defaults to STORELIST_PROVIDER env var or "all".qstringoptionalKeyword search querysortstringoptionalSort fields, comma-separated. Prefix with - for descending. Always include rank as secondary sort.
Examples: "-er,rank" (sales desc), "-pc,rank" (products desc), "-empc,rank" (employees desc),
"rank" (rank asc), "-fc_10,rank" (TikTok followers desc), "-fc_6,rank" (Pinterest desc),
"-cratyyyymmddnco,rank" (newest first), "-mas,rank" (monthly app spend desc)storeleadsmcp_search_technologies#Search technologies used by e-commerce stores. Filter by install count.7 params
Search technologies used by e-commerce stores. Filter by install count.
fieldsstringoptionalComma-separated fields to returnfiltersobjectoptionalFilter object. Common filters:
- "f:icmin"/"f:icmax": install count rangepagenumberoptionalPage numberpage_sizenumberoptionalResults per pageproviderstringoptionalPlatform provider (default: "all")qstringoptionalKeyword search querysortstringoptionalSort fields (e.g. '-installs')