Back to resources

MCP SERVER

Boolsai Grep

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

SUMMARY

What it does

Boolsai Grep is an MCP server that provides parallel regex search across all Boolsai scans. It offers four tools: grep_pattern (run a JavaScript regex across every scan, returning matching site URLs and optional snippets), count_pattern (same as grep_pattern but returns only the count of matching sites), sites_with_signal (return sites that have a known signal_type=signal_value pair in id_index, using pre-indexed D1 lookup), and list_signal_types (returns the full catalog of signal_types currently present in id_index, with counts of unique values and unique domains). The server is designed for ad-hoc discovery of patterns not already extracted into id_index, with options to narrow by vendor, TLD, date, or domain substring. It is accessible via streamable HTTP at https://grep.boolsai.ai/mcp.

CAPABILITIES

Capabilities and scope

Evidence-backed capability profile

data.searchweight 100 · confidence 90data.retrieveweight 80 · confidence 90data.analyzeweight 60 · confidence 70

TOOLS IN THIS MCP SERVER

Tools exposed by this MCP server

count_patternCount Pattern

Same as grep_pattern but returns only the count of matching sites. Faster — no per-match serialization. Useful for sizing 'how many sites use X' before doing a full grep.

Effect: readConfirm: explicit policy
grep_patternGrep Pattern

Run a JavaScript regex across every scan we've ever taken. Returns matching site URLs (and optional snippets). Best for ad-hoc discovery of patterns NOT already extracted into id_index. Pass narrowing filters (vendor, tld, since) to keep scan volume manageable. Default returns URLs only — set with_snippets=true if you also want the matched JSON context.

Effect: readConfirm: explicit policy
list_signal_typesList Signal Types

Returns the full catalog of signal_types currently present in id_index, with counts of unique values and unique domains for each.

Effect: readConfirm: explicit policy
sites_with_signalSites With Signal

Return sites that have a known signal_type=signal_value pair in id_index. MUCH faster than grep_pattern — uses pre-indexed D1 lookup. Use this whenever the signal_type is in the list (see instructions). Examples: sites_with_signal(signal_type='vendor', signal_value='mparticle_workspace') ← won't work, that's an ID type, use sites_with_signal(signal_type='mparticle_workspace') WITHOUT signal_value to list all values + their domains.

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.