SwarmHawk MCP Server

Connect your AI assistant directly to your live domain security data. Ask Claude, Cursor, or any MCP-compatible tool to scan domains, surface breach risks, and explain findings — all from a single conversation.

Last updated March 2026 · MCP server: https://swarmhawk.com/api/mcp

What is MCP?

The Model Context Protocol (MCP) is an open standard created by Anthropic that lets AI assistants call external tools and data sources in a structured, sandboxed way. Think of it like a USB-C port for AI: any MCP-compatible client (Claude, Cursor, Windsurf, Cline…) can plug into any MCP server and immediately gain access to its tools.

When you connect the SwarmHawk MCP server to your AI tool, the assistant can read your live scan results, query domain risk scores, and explain findings — without you having to copy-paste data in or out. The AI operates on your real, current security posture, not a stale export.

What the AI can do via MCP:

• List all your domains and their current risk scores
• Fetch the full scan report for any domain, including every finding
• Trigger a fresh scan on demand
• Get aggregate statistics across your entire portfolio
• Check scanner pipeline health

Prerequisites

Server URL & Auth

All clients point to the same server endpoint:

https://swarmhawk.com/api/mcp

Authentication is a Bearer token sent in the Authorization header, or in the apiKey / api_key field depending on the client. Your API key is available in the dashboard Account tab. Keys never expire but can be regenerated.

Setup by Client

Pick your AI tool below for the exact configuration steps.

{
  "mcpServers": {
    "swarmhawk": {
      "type": "http",
      "url": "https://swarmhawk.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "swarmhawk": {
      "url": "https://swarmhawk.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "name": "swarmhawk",
  "endpoint": "https://swarmhawk.com/api/mcp",
  "auth": {
    "type": "bearer",
    "token": "YOUR_API_KEY"
  }
}

{
  "mcpServers": {
    "swarmhawk": {
      "url": "https://swarmhawk.com/api/mcp",
      "apiKey": "YOUR_API_KEY"
    }
  }
}

pip install mcp fastapi uvicorn httpx

# Minimal SwarmHawk MCP proxy
import os, httpx
from mcp.server.fastmcp import FastMCP

API = "https://swarmhawk.com/api"
KEY = os.environ["SWARMHAWK_API_KEY"]
HEADERS = {"Authorization": f"Bearer {KEY}"}

mcp = FastMCP("swarmhawk")

@mcp.tool()
async def list_domains():
    """Return all domains with risk score and scan status."""
    r = httpx.get(f"{API}/domains", headers=HEADERS)
    return r.json()

@mcp.tool()
async def get_scan_result(domain: str):
    """Full findings for a specific domain."""
    r = httpx.get(f"{API}/scan-results/{domain}", headers=HEADERS)
    return r.json()

if __name__ == "__main__":
    mcp.run(transport="sse")

SWARMHAWK_API_KEY=swh_xxx python swarmhawk_mcp.py

All 9 MCP Tools

Once connected, your AI assistant has access to these tools. You don't call them directly — just ask a question and the AI picks the right tool automatically.

Example Prompts

These prompts work across all MCP-compatible clients. The AI automatically selects the appropriate tool(s).

Security overview

Remediation help

Compliance

Operations

Troubleshooting

Getting Your API Key

Last updated March 2026 · swarmhawk.com · Knowledge Base · Privacy