Skip to main content
Available for all users. Quotas apply based on subscription tier.

Overview

The urlDNA AI Agent is a next-generation security assistant that transforms natural language into actionable threat intelligence. Powered by the urlDNA MCP Server, the agent can autonomously execute scans, hunt for threats using CQL, manage brand monitoring, and answer technical questions by searching the official documentation.

Features

  • Autonomous Scanning & Analysis: Request instant reputation checks or trigger deep-dive scans without leaving the chat.
  • Natural Language CQL: Search our global database using plain English (e.g., “Find all malicious domains using Alpine Linux”).
  • Brand Protection: Monitor and manage your brand assets and saved queries through conversational commands.
  • Real-time Doc Access: The agent can search the OpenAPI and official docs to provide code snippets or explain API parameters.

Available Tools

The AI Agent utilizes a comprehensive suite of tools to interact with the urlDNA ecosystem:
ToolDescription
Fast CheckInstantly check if a URL is SAFE, MALICIOUS, or UNRATED.
Create ScanSubmit a URL for a full scan (results in ~30–60s).
SearchSearch scans using CQL (Custom Query Language).

Saved Queries & Brands

ToolDescription
List QueriesView all saved Custom Query Language (CQL) filters in your account.
Create QuerySet up a new saved query for automated threat monitoring.
Update QueryModify existing query names or CQL filter conditions.
Delete QueryPermanently remove a saved query object from your account.
Query ScansFetch all scan results matching a specific query.
List BrandsSearch and browse monitored brands.
Brand ScansAccess all security scans specifically associated with a monitored brand.

Documentation

ToolDescription
DocumentationFetch the full urlDNA OpenAPI and technical documentation.

Usage & Quotas

The AI Agent operates using your personal urlDNA API Key. Note that every tool execution (scanning, searching, brand retrieval) consumes your Daily API Quota. The chat interface itself follows these daily limits:
  • PREMIUM Users: 100 daily chat requests.
  • FREE Users: 20 daily chat requests.

Examples

  • Threat Hunting
Scan this url: example.com and tell me if malicious.