brand_audit_batch_start
ActiveTool of com.blackveilsecurity/dns
declared in 3.29.5
Enqueue an async brand audit across up to 50 target domains with optional standard/deep discovery depth, brand aliases, and caller-supplied candidate domains. Returns { auditId, queuedAt, targetCount, etaSeconds } immediately; poll with brand_audit_status and fetch results with brand_audit_get_report once complete. Each target consumes 1 unit of the monthly BRAND_AUDIT_QUOTAS budget.
Parameters schema
{
"type": "object",
"required": [
"domains"
],
"properties": {
"view": {
"enum": [
"standard",
"csc_complement"
],
"type": "string",
"description": "Output view mode. 'csc_complement' produces a CSC-tuned payload; requires enterprise tier. Default 'standard'."
},
"depth": {
"enum": [
"standard",
"deep"
],
"type": "string",
"description": "Discovery depth. standard is default; deep expands candidate seeding and enrichment fanout."
},
"format": {
"anyOf": [
{
"type": "string",
"const": "json"
},
{
"type": "string",
"const": "markdown"
},
{
"type": "string",
"const": "both"
}
],
"description": "Inline output mode. Defaults to \"both\"."
},
"domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"minLength": 1
},
"maxItems": 50,
"minItems": 1,
"description": "Domains to audit (max 50 per batch). Duplicates are merged."
},
"planner_mode": {
"enum": [
"off",
"observe",
"enforce"
],
"type": "string",
"description": "Planner mode for staged discovery fanout. observe emits metrics; enforce applies candidate-backed signal caps."
},
"brand_aliases": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 2
},
"maxItems": 20,
"description": "Optional public brand aliases to seed, such as product or legal-entity labels."
},
"discovery_mode": {
"enum": [
"classic",
"tiered"
],
"type": "string",
"description": "Brand-discovery pipeline mode. classic = legacy sweep; tiered = tenant/graph/evidence wrappers first (BlackVeil-internal)."
},
"min_confidence": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Drop candidates whose combined confidence falls below this threshold (0-1, default 0.5)."
},
"candidate_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"minLength": 1
},
"maxItems": 250,
"description": "Optional candidate domains supplied by the caller for corroboration."
},
"ownership_verified": {
"type": "boolean",
"description": "Caller attests that the target domains are owned or authorized for scanning. Required when discovery_mode is \"tiered\" and the caller is not an enterprise/owner/partner principal."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
com.blackveilsecurity/dns
https://github.com/MadaBurns/bv-mcp
2/7 registries