Provides AI agents with offline full-text search and section-level retrieval over the HackTricks offensive security wiki.
Also known as zebbern/hacktricks-mcp, @zebbern/hacktricks-mcp
- Stars
- 4
- Tools
- 3
- Downloads, 30 days
- —
- Latest version
- 0.1.5
- Last commit
- Nov 16, 2026
- License
- —
What is HackTricks MCP?
HackTricks provides AI agents with offline full-text search and section-level retrieval over the HackTricks offensive security wiki. It exposes 3 tools, such as hacktricks_search, hacktricks_get_page, hacktricks_get_toc.
Summary generated from the project's README
About HackTricks MCP server
Providing AI agents with offline full-text search and section-level retrieval over the HackTricks offensive security wiki is what this server enables. Security researchers and penetration testers can use it within clients like Claude Desktop, Cursor, Kimi, or via command line interfaces such as Claude Code and Codex CLI. It operates locally using Node.js 22.13 or newer and requires no network access at query time because it includes a pre-built SQLite FTS5 search index containing over 1,000 pages.
Users interact with the wiki through specific tools including hacktricks_search for ranked results with snippets, hacktricks_get_page for reading specific sections or code blocks, and hacktricks_get_toc to view the category tree. The index stays updated through a GitHub Action that re-syncs with the upstream repository every 3 days. Because it uses the built-in node:sqlite module, it avoids native dependencies and does not require a manual clone or ripgrep installation.
What you can do with it
- 1Retrieve specific attack commandsAsk the agent to find and display the exact commands needed for a kerberoast attack.
- 2Investigate privilege escalation pathsRequest instructions on how to escalate privileges when you are part of the lxd group.
- 3Navigate wiki categoriesLocate the specific section regarding SSRF within the web pentesting pages.
Written from the project's README. Every use case is checked against a quote from it.
How to install HackTricks MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall HackTricks MCP in Claude Code
$ claude mcp add hacktricks-mcp -- npx -y @zebbern/hacktricks-mcpInstall HackTricks MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hacktricks-mcp": {
"command": "npx",
"args": [
"-y",
"@zebbern/hacktricks-mcp"
]
}
}
}Install HackTricks MCP in VS Code
.vscode/mcp.json
{
"servers": {
"hacktricks-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zebbern/hacktricks-mcp"
]
}
}
}Install HackTricks MCP in VS Code CLI
$ code --add-mcp '{"name":"hacktricks-mcp","type":"stdio","command":"npx","args":["-y","@zebbern/hacktricks-mcp"]}'Install HackTricks MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"hacktricks-mcp": {
"command": "npx",
"args": [
"-y",
"@zebbern/hacktricks-mcp"
]
}
}
}Install HackTricks MCP in Codex
$ codex mcp add hacktricks-mcp -- npx -y @zebbern/hacktricks-mcpInstall HackTricks MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.hacktricks-mcp] command = "npx" args = ["-y", "@zebbern/hacktricks-mcp"]
Install HackTricks MCP in Gemini CLI
$ gemini mcp add -s user hacktricks-mcp npx -- -y @zebbern/hacktricks-mcpInstall HackTricks MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"hacktricks-mcp": {
"command": "npx",
"args": [
"-y",
"@zebbern/hacktricks-mcp"
]
}
}
}HackTricks MCP tools 3
Detected from the READMEhacktricks_searchhacktricks_get_pagehacktricks_get_toc
| hacktricks_search | — | |
| hacktricks_get_page | — | |
| hacktricks_get_toc | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablezebbern/hacktricks-mcp is public and reachablegithub.com/zebbern/hacktricks-mcp ↗Pass
- Package names this repository as its source@zebbern/hacktricks-mcp names zebbern/hacktricks-mcp as sourcenpmjs.com/package/@zebbern/hacktricks-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @zebbern/hacktricks-mcpnpmjs.com/package/@zebbern/hacktricks-mcp/v/0.1.5#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-13github.com/zebbern/hacktricks-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @zebbern/hacktricks-mcpPass
- No critical advisory in the package or its dependencies105 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model3 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubhacktricks-mcp
MCP server that gives AI agents fast, offline full-text search and section-level retrieval over the HackTricks offensive-security wiki.
Unlike grep-based alternatives, this server ships with a pre-built SQLite FTS5 search index (1,000+ pages) inside the package. No install-time clone, no ripgrep dependency, no network access at query time. A GitHub Action re-syncs the index with upstream every 3 days and commits it back to this repo.
Quick start
Requirements: Node.js 22.13 or newer (uses the built-in node:sqlite, zero native dependencies).
Claude Code:
claude mcp add hacktricks -- npx -y @zebbern/hacktricks-mcp
Codex CLI:
codex mcp add hacktricks -- npx -y @zebbern/hacktricks-mcp
Any MCP client (Claude Desktop, Cursor, Kimi, etc.), config JSON:
{
"mcpServers": {
"hacktricks": {
"command": "npx",
"args": ["-y", "@zebbern/hacktricks-mcp"]
}
}
}
As a plugin (bundles the agent skill that teaches efficient usage): this repo is a valid plugin for Claude Code (.claude-plugin/), Codex (.codex-plugin/) and Kimi (kimi-plugin/). Add it from your client's plugin marketplace flow pointing at zebbern/hacktricks-mcp, or for Kimi Work use this plugin link.
Then ask things like:
- "Search HackTricks for kerberoast and give me the attack commands"
- "How do I escalate privileges from the lxd group?"
- "Show me the SSRF section of the pentesting-web pages"
Tools at a glance
| Tool | What it does |
|---|---|
hacktricks_search |
Ranked full-text search with snippets, category filter and abbreviation handling (privesc, sqli, rce, ...) |
hacktricks_get_page |
Read a page, a single section, or just its code blocks |
hacktricks_get_toc |
The wiki category tree, so agents can see where topics live |
All tools are strictly read-only. Full reference: docs/tools.md.
Documentation
- docs/tools.md: complete tool reference with parameters and examples
- docs/architecture.md: how the index and the 3-day sync work
- docs/development.md: local setup, tests, releasing
- docs/agents.md: agent skill, MCP registry and plugin packaging
Security and legal
- The server executes nothing from the wiki; it is a read-only search interface. All queries are parameterized, and user input is escaped before query construction.
- HackTricks content is offensive-security reference material. Use it only on systems you are authorized to test.
- Content belongs to HackTricks / Carlos Polop and contributors; this repo contains derived index data plus original server code (MIT).
Credits
- HackTricks by Carlos Polop and contributors
- Model Context Protocol SDK
HackTricks MCP questions
How do I add HackTricks MCP to Claude Code?
Run claude mcp add hacktricks-mcp -- npx -y @zebbern/hacktricks-mcp in your terminal. Add --scope user to make it available in every project.
How do I add HackTricks MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does HackTricks MCP provide?
It exposes 3 tools, including hacktricks_search, hacktricks_get_page, hacktricks_get_toc.
Does this server require an internet connection to search?
No, the server uses a pre-built SQLite FTS5 search index, meaning there is no network access required at query time.
How often is the HackTricks wiki content updated?
The index is automatically re-synced with the upstream wiki every 3 days via a GitHub Action.
Can the server modify the HackTricks wiki?
No, all tools provided by the server are strictly read-only.
What are the system requirements to run this server?
You need Node.js version 22.13 or newer installed.