query_scans
Retrieve all matching scans for a saved query.
How to use it
query_scans is exposed by the MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the query_scans tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install MCP
docker run -p 8080:8080 -e x-api-key=<URLDNA_API_KEY> urldna-mcp-serverOther tools in MCP (13)
Get all scans associated with a brand. Supports additional CQL filtering.
Create a new saved query with one or more CQL filter conditions.
Permanently delete a saved query by ID.
Instantly check if a URL has been scanned. Returns SAFE / MALICIOUS / UNRATED.
Retrieve full details of a specific brand by ID.
Retrieve a specific saved query and its filters by ID.
Retrieve a complete scan result by ID.
List available brands with optional name search and visibility filter (ALL / FREE / PREMIUM / USERBRANDS).
List all saved queries for the authenticated user.
Submit a URL for a full scan and wait for the result (~30–60s).
Search scans using CQL (Custom Query Language) across domain, IP, technology, malicious flag, and more. Supports pagination (page 2+ requires PREMIUM).
Fetch the full urlDNA OpenAPI and documentations.
Update an existing query's name and filters (full replacement).