> ## 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.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.