Recon-ng

MCP server exposing full recon-ng OSINT framework functionality to LLMs.

PyPI Python Ruff

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 workspaces
• workspace_create(name) - Create a new workspace
• workspace_switch(name) - Switch to a workspace
• workspace_delete(name) - Delete a workspace

Module Management

• module_list(category) - List available modules
• module_load(module_path) - Load a module
• module_unload() - Unload current module
• module_options_list() - List module options
• module_options_set(key, value) - Set module option
• module_run() - Run loaded module

Marketplace

• marketplace_search(query) - Search marketplace
• marketplace_install(module_path) - Install module
• marketplace_remove(module_path) - Remove module

Database Operations

• db_query(table, where) - Query database
• db_insert(table, data) - Insert record
• db_delete(table, where) - Delete records

Utilities

• run_command(command) - Execute recon-ng command
• get_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/