Summary
This wraps the recon-ng OSINT framework so LLMs can drive reconnaissance workflows programmatically. You get workspace management for organizing investigations, module loading and execution for tasks like WHOIS lookups and domain enumeration, marketplace access to install additional recon modules, and direct database queries against collected intelligence. It exposes recon-ng's command interface through structured tools like module_load, module_options_set, and module_run, plus db_query for pulling results. Reach for this when you want conversational access to systematic reconnaissance without manually navigating recon-ng's CLI, especially useful for iterative OSINT gathering where an LLM can chain together modules based on discovered data.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →mcp-recon-ng
MCP server exposing full recon-ng OSINT framework functionality to LLMs.
mcp-name: io.github.daedalus/mcp-recon-ng
Install
pip install mcp-recon-ng
Requires recon-ng to be installed separately:
pip install recon-ng
Usage
CLI
mcp-recon-ng
MCP Client Configuration
Add to your MCP client config:
{
"mcpServers": {
"recon-ng": {
"command": "mcp-recon-ng",
"env": {}
}
}
}
Available Tools
Workspace Management
workspace_list()- List all workspacesworkspace_create(name)- Create a new workspaceworkspace_switch(name)- Switch to a workspaceworkspace_delete(name)- Delete a workspace
Module Management
module_list(category)- List available modulesmodule_load(module_path)- Load a modulemodule_unload()- Unload current modulemodule_options_list()- List module optionsmodule_options_set(key, value)- Set module optionmodule_run()- Run loaded module
Marketplace
marketplace_search(query)- Search marketplacemarketplace_install(module_path)- Install modulemarketplace_remove(module_path)- Remove module
Database Operations
db_query(table, where)- Query databasedb_insert(table, data)- Insert recorddb_delete(table, where)- Delete records
Utilities
run_command(command)- Execute recon-ng commandget_info()- Get system information
Example
from mcp_recon_ng import workspace_create, module_load, module_run
# Create a new workspace
workspace_create("osint_project")
# Load a module
module_load("recon/domains-whois/whois_miner")
# Set module options
module_options_set("SOURCE", "example.com")
# Run the module
result = module_run()
Development
git clone https://github.com/daedalus/mcp-recon-ng.git
cd mcp-recon-ng
pip install -e ".[test]"
# run tests
pytest
# format
ruff format src/ tests/
# lint
ruff check src/ tests/
# type check
mypy src/
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →