urldna-mcp MCP Server

The urlDNA MCP Server enables native tool use for security-focused LLM agents like OpenAI GPT, Google Gemini and Claude Desktop, providing a direct interface to interact with the urlDNA threat…

Local serverstdio

What is the urldna-mcp Server?

urldna-mcp is an MCP project maintained in the urldna/mcp repository. The maintainer describes its purpose as “The urlDNA MCP Server enables native tool use for security-focused LLM agents like OpenAI GPT, Google Gemini and Claude Desktop, providing a direct interface to…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares x-api-key. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
fast_checkInstantly check if a URL has been scanned. Returns SAFE / MALICIOUS / UNRATED.
new_scanSubmit a URL for a full scan and wait for the result (~30–60s).
get_scanRetrieve a complete scan result by ID.
searchSearch scans using CQL (Custom Query Language) across domain, IP, technology, malicious flag, and more. Supports AND and OR expressions plus pagination (page…
list_queriesList all saved queries for the authenticated user.
get_queryRetrieve a specific saved query and its filters by ID.
create_queryCreate a new saved query with one or more CQL filter conditions.
update_queryUpdate an existing query's name and filters (full replacement).
delete_queryPermanently delete a saved query by ID.
query_scansRetrieve all matching scans for a saved query.
list_brandsList available brands with optional name search and visibility filter (ALL / FREE / PREMIUM / USER_BRANDS).
get_brandRetrieve full details of a specific brand by ID.
brand_scansGet all scans associated with a brand. Supports additional CQL filtering.
search_docsFetch the full urlDNA OpenAPI and documentations.

How to install the urldna-mcp Server

{
  "mcpServers": {
    "urlDNA": {
      "command": "uv",
      "args": [
        "--directory",
        "<YOUR_PATH>\\urldna_mcp",
        "run",
        "urldna_mcp\\run.py"
      ],
      "env": {
        "x-api-key": "YOUR_x-api-key"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
x-api-keyDeclared in the maintainer’s client configuration.Check documentation