StoreLeads MCP connector
Bearer Token CRM & 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.
domains array required Array of domain names to look up (max 100) fields string optional Comma-separated fields to return provider string optional Platform 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.
name string required Company name to look up provider string optional Platform 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.
name string required Domain name to detect (e.g. 'example.com') provider string optional Platform 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.
token string required App token/slug identifier fields string optional Comma-separated fields to return provider string optional Platform provider (default: "all") storeleadsmcp_get_app_reviews
#
Get reviews for a specific app. 2 params
Get reviews for a specific app.
token string required App token/slug identifier provider string optional Platform 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.
name string required Domain name (e.g. 'example.com') fields string optional Comma-separated fields to return provider string optional Platform 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.
id number required Internal domain ID fields string optional Comma-separated fields to return provider string optional Platform provider (default: "all") storeleadsmcp_get_historical_domains
#
Get domains from a specific historical snapshot. 4 params
Get domains from a specific historical snapshot.
label string required Historical snapshot label (from list_historical_datasets) page number optional Page number page_size number optional Results per page provider string optional Platform provider (default: "all") storeleadsmcp_get_platforms
#
List all available e-commerce platforms/providers. 1 param
List all available e-commerce platforms/providers.
provider string optional Platform provider (default: "all") storeleadsmcp_get_product
#
Get a specific product by its ID. 2 params
Get a specific product by its ID.
id number required Product ID provider string optional Platform 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.
name string required Domain name (e.g. 'example.com') provider string optional Platform 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.
name string required Technology name (e.g. 'Klaviyo') fields string optional Comma-separated fields to return provider string optional Platform provider (default: "all") storeleadsmcp_list_historical_datasets
#
List available historical domain snapshots. 1 param
List available historical domain snapshots.
provider string optional Platform 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.
fields string optional Comma-separated fields to return filters object optional Filter 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 range page number optional Page number page_size number optional Results per page provider string optional Platform provider (default: "all") q string optional Keyword search query sort string optional Sort 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.
cursor string optional Pagination cursor from previous response fields string optional Comma-separated fields to return (e.g. 'name,platform,estimated_sales,country_code') filters object optional Filter 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 values page number optional Page number (0-indexed) page_size number optional Results per page (default: 50, max: 5000) provider string optional Platform provider (e.g. "shopify", "woocommerce", "bigcommerce", "all"). Defaults to STORELIST_PROVIDER env var or "all". q string optional Keyword search query sort string optional Sort 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.
fields string optional Comma-separated fields to return filters object optional Filter object. Common filters:
- "f:icmin"/"f:icmax": install count range page number optional Page number page_size number optional Results per page provider string optional Platform provider (default: "all") q string optional Keyword search query sort string optional Sort fields (e.g. '-installs')