# mcp-recon-ng [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/daedalus/mcp-recon-ng  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-recon-ng

## Description
MCP server exposing full recon-ng OSINT framework functionality

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-recon-ng": {
    "command": "uvx",
    "args": ["mcp-recon-ng"]
  }
}
```

## Documentation & README

# mcp-recon-ng

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

[![PyPI](https://img.shields.io/pypi/v/mcp-recon-ng.svg)](https://pypi.org/project/mcp-recon-ng/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-recon-ng.svg)](https://pypi.org/project/mcp-recon-ng/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

mcp-name: io.github.daedalus/mcp-recon-ng

## Install

```bash
pip install mcp-recon-ng
```

Requires recon-ng to be installed separately:
```bash
pip install recon-ng
```

## Usage

### CLI

```bash
mcp-recon-ng
```

### MCP Client Configuration

Add to your MCP client config:

```json
{
  "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

```python
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

```bash
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/
```