Beagle Security — Claude Code MCP server: setup and overview
Connects AI assistants to Beagle Security to manage projects, run automated penetration tests, and fetch vulnerability reports.
no license updated 2026-10-29
Open on GitHubWhat Beagle Security does
This MCP server exposes Beagle Security API v2.0 directly to language models. It provides 18 distinct tools covering project operations, application records, domain ownership checks, and test lifecycle orchestration.
Your agent can trigger domain verification using DNS, hosted files, or API signatures, initiate security assessments, check scan progress, and download complete vulnerability findings formatted as JSON. Team project filtering is supported out of the box.
Authentication requires a valid BEAGLE_SECURITY_API_TOKEN set in your environment; without it, all external API requests will fail. You can host the integration directly with Node.js or run it inside a Docker container.
What it helps with
- trigger and stop automated penetration tests from your coding assistant
- inspect running test progress and retrieve vulnerability payloads in JSON
- complete domain verification steps using DNS records, hosted files, or API endpoints
- create and update project entities and target applications in Beagle Security
Example prompts for the agent
- List all existing applications and workspaces using beagle_list_projects
- Start a new automated penetration test via beagle_start_test and poll its state
- Fetch the verification signature for our target domain using beagle_get_domain_signature
How to install Beagle Security
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Beagle Security
What does Beagle Security MCP server do?
It integrates Beagle Security API v2.0 into MCP-compliant editors, offering 18 tools to handle workspaces, verify host ownership, and orchestrate automated security testing.
How to install and run Beagle Security MCP server?
Clone the repository, execute npm install followed by npm run build, then configure your client mcpServers setting with the compiled build/index.js path and your BEAGLE_SECURITY_API_TOKEN.
Which verification methods does the server handle?
The beagle_verify_domain tool validates ownership against targets using FILE, DNS, or direct API signature checks.