urlDNA 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 intelligence platform via API.
The repository exposes the same toolset over two transports:
stdiofor local desktop integrations such as Claude Desktop.streamable-httpfor hosted deployments such as Cloud Run.
Installation & Setup
This project uses uv for fast Python package management.
Prerequisites
Install uv if you haven't already:
# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Or with pip
pip install uvQuick Start
- Clone and setup the project:
git clone <repository-url>
cd urlDNA-mcp-server
uv sync- Run the MCP server locally (stdio mode):
uv run python urldna_mcp/run.py- Run the MCP server in streamable HTTP mode:
uv run python urldna_mcp/server.pyThe hosted server reads these environment variables:






