search
Search scans using CQL (Custom Query Language) across domain, IP, technology, malicious flag, and more. Supports pagination (page 2+ requires PREMIUM).
How to use it
search is exposed by the MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the search 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).
Retrieve all matching scans for a saved query.
Fetch the full urlDNA OpenAPI and documentations.
Update an existing query's name and filters (full replacement).