MCP-Server

Boolsai Directory

ai.boolsai/directory
Commerce & Retail Vertrieb & CRM Nicht verfügbar MCP 2026-07-28

Was dieses MCP kann

Indexes ecommerce brands and technology stacks for site intelligence, competitor comparisons, operator discovery, and outbound prospecting.

brands_by_founder
List brands attributed to a founder (from Schema.org Organization markup). Useful for tracking serial DTC founders.
Eingabeschema
{'type': 'object', 'required': ['founder'], 'properties': {'founder': {'type': 'string', 'description': 'Founder name (case-insensitive)'}}}
brands_in_city
List indexed brands that publish a physical address in a given city. Sourced from Schema.org Organization JSON-LD.
Eingabeschema
{'type': 'object', 'required': ['city'], 'properties': {'city': {'type': 'string', 'description': "City name, e.g. 'Los Angeles', 'New York', 'Berlin'"}}}
brands_in_market
List indexed brands explicitly serving a country market (via hreflang). Country is a 2-letter ISO code, lowercase.
Eingabeschema
{'type': 'object', 'required': ['country'], 'properties': {'country': {'type': 'string', 'description': "2-letter country code, e.g. 'us', 'gb', 'de', 'fr'"}}}
bulk_export
Paginated bulk export of indexed sites matching a filter. Returns up to 1000 rows per page in CSV or JSONL format with a cursor for continued pages. Use this when an agency needs an outbound prospect list (e.g. all sites using Klaviyo in the US) for CRM import. The full row count is also returned so you can size the export.
Eingabeschema
{'type': 'object', 'required': ['signal_type'], 'properties': {'limit': {'type': 'integer', 'default': 1000, 'description': 'Max rows per page (default 1000, max 5000)'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor from previous page; pass to get next 1000 rows'}, 'format': {'enum': ['csv', 'jsonl', 'json'], 'type': 'string', 'default': 'csv', 'description': 'Output format. CSV is best for CRM import.'}, 'signal_type': {'type': 'string', 'description': "Required. e.g. 'vendor', 'klaviyo_company_id', 'shopify_shopid', 'market_country', 'org_country'. Use list_signal_types via Boolsai Grep to discover."}, 'signal_value': {'type': 'string', 'description': 'Optional exact value to filter. If omitted returns ANY value of this signal_type.'}, 'market_country': {'type': 'string', 'description': "Optional ISO-2 country code (e.g. 'us', 'au') to intersect with hreflang market data"}}}
bulk_export_url
Returns a streaming-export URL for the same filter as bulk_export. Useful when the agency wants to pull 50K rows in one shot via curl/HTTP pipe instead of paginating the MCP. The URL is public, no auth, returns NDJSON or CSV with HTTP chunked-transfer streaming. Use bulk_export when N<1000; use this for bigger exports.
Eingabeschema
{'type': 'object', 'required': ['signal_type'], 'properties': {'format': {'enum': ['ndjson', 'csv'], 'type': 'string', 'default': 'ndjson'}, 'signal_type': {'type': 'string', 'description': 'Required signal_type'}, 'signal_value': {'type': 'string', 'description': 'Optional exact value'}, 'market_country': {'type': 'string', 'description': 'Optional ISO-2 country'}}}
compare_scans
Compare two historical scans of the same URL to surface stack changes. Returns added/removed/changed vendors, account IDs, and inline-script signals between scan A and scan B. Use this for competitor watch — 'what did patagonia.com just deploy?'. If t1/t2 are omitted, compares oldest vs newest available scan.
Eingabeschema
{'type': 'object', 'required': ['url'], 'properties': {'t1': {'type': 'string', 'description': 'Optional ISO timestamp of first scan (oldest if omitted)'}, 't2': {'type': 'string', 'description': 'Optional ISO timestamp of second scan (newest if omitted)'}, 'url': {'type': 'string', 'description': 'Domain or full URL to compare'}}}
compare_sites
Side-by-side stack comparison of 2-5 domains. Returns each site's vendors, account IDs, brand info, markets — and which signals are shared / unique per site. Good for 'compare X.com vs Y.com' or competitive teardowns.
Eingabeschema
{'type': 'object', 'required': ['urls'], 'properties': {'urls': {'type': 'array', 'items': {'type': 'string'}, 'description': '2-5 domain/URL strings'}}}
directory_query
Unified query against the Boolsai Directory. One tool to rule the other lookups. Pass any combination of: signal_type+signal_value, domain, market_country, archetype, founder, city. Returns matching sites + their key signals. Prefer this over the granular tools when you have multiple filter conditions to AND together.
Eingabeschema
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'case-insensitive city name'}, 'limit': {'type': 'integer', 'default': 50, 'description': 'max rows (1-500)'}, 'domain': {'type': 'string', 'description': "exact domain match (e.g. 'gymshark.com')"}, 'founder': {'type': 'string', 'description': 'case-insensitive substring'}, 'archetype': {'type': 'string', 'description': "e.g. 'headless-shopify', 'woocommerce-stores'"}, 'signal_type': {'type': 'string', 'description': "e.g. 'vendor', 'shopify_shopid'"}, 'signal_value': {'type': 'string', 'description': 'exact signal value'}, 'market_country': {'type': 'string', 'description': "ISO-2 (e.g. 'us')"}}}
domain_intel
Free DNS/WHOIS enrichment for a single domain. Returns: email host (Google Workspace / Microsoft 365 / etc. — derived from MX records), DNS provider (Cloudflare / Route 53 / GoDaddy / etc.), CDN provider, registrar, domain age (registered/expires). High-signal outbound data — 'they use Google Workspace + Cloudflare DNS + registered with GoDaddy' tells you a lot about org size + sophistication. Results cached 24h. Free — uses Cloudflare DoH + public RDAP.
Eingabeschema
{'type': 'object', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'description': 'Domain to enrich (apex or any subdomain)'}}}
find_similar_by_stack
Find sites with the most-similar vendor stack to a given domain using Jaccard similarity over the full vendor set (not just archetype labels). Returns the top N matches with similarity scores. Use this when stack_archetype labels are too coarse and you want 'show me 20 brands running an almost-identical stack to liquiddeath.com'. More accurate than similar_sites for niche stacks.
Eingabeschema
{'type': 'object', 'required': ['domain'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'description': 'max similar sites (1-100)'}, 'domain': {'type': 'string', 'description': 'Reference domain'}, 'min_shared': {'type': 'integer', 'default': 3, 'description': 'Minimum shared distinctive vendors required to be considered (default 3)'}}}
lookup_id
Cross-reference any tenant-unique account ID across the index. Useful for 'who else shares this GTM container / Klaviyo company / Sentry org / Meta pixel ID?'. Signal types: gtm_container, ga4_measurement, ga_ua, klaviyo_company_id, meta_pixel_id, shopify_shopid, myshopify_slug, hotjar_id, intercom_app_id, hubspot_portal, klaviyo_subscriber, tiktok_pixel, stripe_pk_live, sentry_dsn_org, tealium_tenant, optimizely_project, mparticle_workspace, segment_writekey, abtasty_account, fullstory_org, pendo_account, intellimize_acct, webflow_site_id, dynamic_yield, wunderkind_site, elevar_id.
Eingabeschema
{'type': 'object', 'required': ['signal_type', 'signal_value'], 'properties': {'signal_type': {'type': 'string', 'description': "e.g. 'gtm_container', 'klaviyo_company_id', 'sentry_dsn_org'"}, 'signal_value': {'type': 'string', 'description': "the actual ID/value, e.g. 'GTM-XYZABC', 'H2zzaR'"}}}
operator_cluster
Find every domain sharing a tenant-unique ID — the most powerful single signal in Boolsai. Given a Stripe pk_live key, Sentry DSN org, Klaviyo company_id, mParticle workspace, GTM container, GA4 measurement, Shopify shop_id, or other tenant ID, returns every domain we've seen using the SAME ID. This surfaces multi-brand operators, holding-company portfolios, sister brands sharing infrastructure, agency-managed clusters. No competitor (BuiltWith, Wappalyzer, etc.) can do this — they only see external hostnames, not the tenant-unique IDs leaked client-side. Use this when you want to discover the actual operator behind a brand, or expand a single brand into its full portfolio.
Eingabeschema
{'type': 'object', 'properties': {'id': {'type': 'string', 'description': "The tenant ID itself (e.g. 'pk_live_abc...', 'GTM-M8TQZPX', 'o307020' for Sentry, '12345678' for Shopify shop_id). signal_type is auto-detected."}, 'limit': {'type': 'integer', 'default': 100, 'description': 'max sites per cluster (1-500)'}, 'domain': {'type': 'string', 'description': "Alternative: pass a domain and we'll return every cluster this domain belongs to (all tenant IDs and their fellow domains)."}, 'signal_type': {'type': 'string', 'description': "Optional explicit signal_type if auto-detect could be ambiguous (e.g. 'stripe_pk_live', 'sentry_dsn_org')."}}}
prospect_brief
ONE-CALL PROSPECT BRIEF for agency outbound — runs four sub-queries against the live indexed data: (1) full dossier of the prospect's stack, (2) sister brands sharing tenant IDs (operator cluster), (3) 3-5 similar-stack competitors, (4) structured 'pitch angles' calling out concrete gaps an agency could pitch on (missing consent, no SST, outdated vendors, broken Schema.org, multiple GTM installs). Saves a strategist 20 min of manual cross-referencing per prospect. Use this whenever the user asks 'tell me about prospect.com'.
Eingabeschema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Domain or URL of the prospect'}, 'angle': {'type': 'string', 'description': "Optional agency pitch angle to tune the brief: 'cro', 'analytics', 'consent', 'sst' (server-side tagging), 'headless', 'consolidation'. If omitted, returns all angles found."}}}
similar_sites
Find brands with similar stack archetypes to the given domain. Returns 'sites running similar tech' — useful for benchmarking, prospecting, competitor lookups.
Eingabeschema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Domain to find similar sites for'}}}
site_dossier
Full intel dossier for a single domain: detected vendors grouped by category, account IDs (GTM, GA4, Klaviyo company_id, Shopify shop_id, Meta pixel, Sentry org, Tealium tenant, Stripe pk_live, etc.), brand identity (name, founder, city, employees, social handles), international markets, external host list, and likely operator-cluster siblings. Use for any 'what's running on X.com?' query.
Eingabeschema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': "Domain or URL, e.g. 'gymshark.com' or 'https://gymshark.com/'"}}}
sites_using_vendor
List indexed sites detected using a specific vendor (e.g. 'klaviyo', 'yotpo', 'elevar', 'gorgias', 'rebuy'). Vendor slug is lowercase, underscore-separated. Returns domain list with brand names where known.
Eingabeschema
{'type': 'object', 'required': ['vendor'], 'properties': {'vendor': {'type': 'string', 'description': "Vendor slug, e.g. 'klaviyo', 'shopify', 'webflow', 'onetrust'."}}}
stack_archetype
List brands matching a stack archetype. Valid slugs: headless-shopify, classic-shopify-dtc, server-side-tagged, personalisation-heavy, pixel-stacked, multi-region, woocommerce-stores, magento-stores, bnpl-enabled, headless-cms.
Eingabeschema
{'type': 'object', 'required': ['archetype'], 'properties': {'archetype': {'type': 'string', 'description': 'Archetype slug'}}}
subdomain_map
Every subdomain of a given root domain we've ever scanned. Reveals storefront topology — where the checkout actually lives, regional storefronts, B2B portals, internal admin domains, asset CDNs. Output groups subdomains by their primary vendor where known. Use this to (a) find the right path to scan for an audit (sometimes the checkout is on us.checkout.brand.com not brand.com), (b) spot enterprise topology (multi-region Plus stores), (c) discover sister surfaces (community, ambassador, careers, etc).
Eingabeschema
{'type': 'object', 'required': ['root'], 'properties': {'root': {'type': 'string', 'description': "Root domain (e.g. 'gymshark.com'). Pass just the apex; we'll find subdomains automatically."}, 'limit': {'type': 'integer', 'default': 200, 'description': 'max subdomains returned (1-1000)'}}}
summary
Global stats for the Boolsai directory: how many sites are indexed, signal types covered, top vendors, most-changed companies. Use at the start of a session to ground what's available.
Eingabeschema
{'type': 'object', 'properties': {}}
Hinzugefügt
directory_query
11. September 2026 15:32
Hinzugefügt
prospect_brief
11. September 2026 15:32
Hinzugefügt
subdomain_map
11. September 2026 15:32
Hinzugefügt
operator_cluster
11. September 2026 15:32
Hinzugefügt
bulk_export_url
11. September 2026 15:32
Hinzugefügt
find_similar_by_stack
11. September 2026 15:32
Hinzugefügt
domain_intel
11. September 2026 15:32
Hinzugefügt
compare_scans
11. September 2026 15:32
Hinzugefügt
bulk_export
11. September 2026 15:32
Hinzugefügt
brands_by_founder
11. September 2026 15:32
Hinzugefügt
similar_sites
11. September 2026 15:32
Hinzugefügt
compare_sites
11. September 2026 15:32
Hinzugefügt
stack_archetype
11. September 2026 15:32
Hinzugefügt
brands_in_market
11. September 2026 15:32
Hinzugefügt
brands_in_city
11. September 2026 15:32
Hinzugefügt
lookup_id
11. September 2026 15:32
Hinzugefügt
sites_using_vendor
11. September 2026 15:32
Hinzugefügt
site_dossier
11. September 2026 15:32
Hinzugefügt
summary
11. September 2026 15:32