AI Agent - urlDNA - Documentation

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:

Scanning & Search

Tool	Description
`Fast Check`	Instantly check if a URL is SAFE, MALICIOUS, or UNRATED.
`Create Scan`	Submit a URL for a full scan (results in ~30–60s).
`Search`	Search scans using CQL (Custom Query Language).

Saved Queries & Brands

Tool	Description
`List Queries`	View all saved Custom Query Language (CQL) filters in your account.
`Create Query`	Set up a new saved query for automated threat monitoring.
`Update Query`	Modify existing query names or CQL filter conditions.
`Delete Query`	Permanently remove a saved query object from your account.
`Query Scans`	Fetch all scan results matching a specific query.
`List Brands`	Search and browse monitored brands.
`Brand Scans`	Access all security scans specifically associated with a monitored brand.

Documentation

Tool	Description
`Documentation`	Fetch 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.

​Overview

​Features

​Available Tools

​Scanning & Search

​Saved Queries & Brands

​Documentation

​Usage & Quotas

​Examples

Overview

Features

Available Tools

Scanning & Search

Saved Queries & Brands

Documentation

Usage & Quotas

Examples