darkmoon — Claude Code plugin: what it does, how to install
An MCP server for your own Darkmoon Pro instance: launch an authorized pentest run, then check its status, campaigns and findings from the agent.
GPL-3.0-only ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install darkmoon@awesome-codex-pluginsWhat darkmoon does
The plugin runs an MCP server, @darkmoon_ai/mcp-server, that connects your coding agent to a Darkmoon Pro dashboard. Four tools come with it. run_pentest kicks off an assessment of one target you are allowed to test and hands back a run_id; get_run_status reports where that run stands; list_campaigns and get_findings only read, listing campaigns and returning vulnerabilities with severity counts.
The server starts with npx -y @darkmoon_ai/mcp-server. The dashboard has to be your own: Darkmoon's engine and CLI are open source, but this server talks to the Pro Dashboard API, which ships self-hosted and has no public endpoint — so DARKMOON_BASE_URL points at your instance. Authentication takes either DARKMOON_USERNAME plus DARKMOON_PASSWORD or a pre-issued DARKMOON_TOKEN; each call requests a fresh JWT instead of reusing a cached one. DARKMOON_TIMEOUT_MS overrides the 60000 ms request timeout.
run_pentest changes state, so aim it at systems you own or have written permission to test. Findings can be wrong, and a person has to review them.
What it helps with
- start a scan of a test environment and get the
run_id - find out whether a run finished or errored out
- browse dashboard campaigns without leaving the chat
- pull a campaign's vulnerabilities grouped by severity
- review findings before opening the dashboard yourself
Example prompts for the agent
- Start a pentest on
staging.example.comwithrun_pentestand give me therun_id. - Check whether the last run finished cleanly or hit an error.
- List the campaigns and show findings for the newest one.
How to install darkmoon
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install darkmoon@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about darkmoon
How do I install darkmoon in Claude Code?
Through the marketplace: first /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install darkmoon@awesome-codex-plugins. Afterwards set DARKMOON_BASE_URL and your dashboard credentials.
What does darkmoon do?
It gives the agent four tools that talk to a Darkmoon Pro dashboard: start a run against a target, read run status, list campaigns, fetch campaign findings.
Does it work with the open source Darkmoon CLI alone?
No. The server calls the Dashboard API, which belongs to Darkmoon Pro and runs on your own infrastructure. Without your own instance there is no endpoint to reach.