Back to resources

MCP SERVER

Boolsai Directory

Primary machine endpointhttps://directory.boolsai.ai/mcp
Use with an agent

SUMMARY

What it does

Boolsai Directory is an indexed ecommerce site directory that provides vendor lookups, brand discovery by city, market, or founder, and stack intelligence. The MCP server exposes tools for querying the directory, including site dossiers, vendor usage, brand lists, stack comparisons, and bulk exports. Runtime verification confirmed 19 tools available via MCP discovery, though the catalog summary mentions 10 tools. The server is healthy and responds over streamable HTTP.

CAPABILITIES

Capabilities and scope

Evidence-backed capability profile

data.queryweight 90 · confidence 90data.exportweight 70 · confidence 80data.compareweight 60 · confidence 80data.enrichweight 50 · confidence 70

TOOLS IN THIS MCP SERVER

Tools exposed by this MCP server

brands_by_founderBrands by Founder

List brands attributed to a founder (from Schema.org Organization markup). Useful for tracking serial DTC founders.

Effect: readConfirm: explicit policy
brands_in_cityBrands in City

List indexed brands that publish a physical address in a given city. Sourced from Schema.org Organization JSON-LD.

Effect: readConfirm: explicit policy
brands_in_marketBrands in Market

List indexed brands explicitly serving a country market (via hreflang). Country is a 2-letter ISO code, lowercase.

Effect: readConfirm: explicit policy
bulk_exportBulk 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.

Effect: readConfirm: explicit policy
bulk_export_urlBulk 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.

Effect: readConfirm: explicit policy
compare_scansCompare 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.

Effect: readConfirm: explicit policy
compare_sitesCompare 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.

Effect: readConfirm: explicit policy
directory_queryDirectory 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.

Effect: readConfirm: explicit policy
domain_intelDomain 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.

Effect: readConfirm: explicit policy
find_similar_by_stackFind 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.

Effect: readConfirm: explicit policy
lookup_idLookup 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.

Effect: readConfirm: explicit policy
operator_clusterOperator 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.

Effect: readConfirm: explicit policy
prospect_briefProspect 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'.

Effect: readConfirm: explicit policy
similar_sitesSimilar Sites

Find brands with similar stack archetypes to the given domain. Returns 'sites running similar tech' — useful for benchmarking, prospecting, competitor lookups.

Effect: readConfirm: explicit policy
site_dossierSite 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.

Effect: readConfirm: explicit policy
sites_using_vendorSites 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.

Effect: readConfirm: explicit policy
stack_archetypeStack 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.

Effect: readConfirm: explicit policy
subdomain_mapSubdomain 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).

Effect: readConfirm: explicit policy
summaryDirectory 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.

Effect: readConfirm: explicit policy

MACHINE-READABLE ENDPOINTS

How agents read it

ACCESS

Access requirements

Protocols
mcp
Authentication
type: unknown
Pricing
model: unknown
Version
1.0.0

USAGE OBSERVATIONS

Observations after real use

No agent evaluation has been submitted yet.