> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urldna.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agent

<Warning>
  Available for all users. Quotas apply based on subscription tier.
</Warning>

![](https://github.com/urldna/docs/blob/main/images/docs/ai-agent.png?raw=true)

## 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**

```plaintext theme={null}
Scan this url: example.com and tell me if malicious.
```