{
  "markdown": "# mcp-recon-ng\n\nMCP server exposing full recon-ng OSINT framework functionality to LLMs.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-recon-ng.svg)](https://pypi.org/project/mcp-recon-ng/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-recon-ng.svg)](https://pypi.org/project/mcp-recon-ng/)\n[![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)\n\nmcp-name: io.github.daedalus/mcp-recon-ng\n\n## Install\n\n```bash\npip install mcp-recon-ng\n```\n\nRequires recon-ng to be installed separately:\n```bash\npip install recon-ng\n```\n\n## Usage\n\n### CLI\n\n```bash\nmcp-recon-ng\n```\n\n### MCP Client Configuration\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"recon-ng\": {\n      \"command\": \"mcp-recon-ng\",\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Workspace Management\n- `workspace_list()` - List all workspaces\n- `workspace_create(name)` - Create a new workspace\n- `workspace_switch(name)` - Switch to a workspace\n- `workspace_delete(name)` - Delete a workspace\n\n### Module Management\n- `module_list(category)` - List available modules\n- `module_load(module_path)` - Load a module\n- `module_unload()` - Unload current module\n- `module_options_list()` - List module options\n- `module_options_set(key, value)` - Set module option\n- `module_run()` - Run loaded module\n\n### Marketplace\n- `marketplace_search(query)` - Search marketplace\n- `marketplace_install(module_path)` - Install module\n- `marketplace_remove(module_path)` - Remove module\n\n### Database Operations\n- `db_query(table, where)` - Query database\n- `db_insert(table, data)` - Insert record\n- `db_delete(table, where)` - Delete records\n\n### Utilities\n- `run_command(command)` - Execute recon-ng command\n- `get_info()` - Get system information\n\n## Example\n\n```python\nfrom mcp_recon_ng import workspace_create, module_load, module_run\n\n# Create a new workspace\nworkspace_create(\"osint_project\")\n\n# Load a module\nmodule_load(\"recon/domains-whois/whois_miner\")\n\n# Set module options\nmodule_options_set(\"SOURCE\", \"example.com\")\n\n# Run the module\nresult = module_run()\n```\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-recon-ng.git\ncd mcp-recon-ng\npip install -e \".[test]\"\n\n# run tests\npytest\n\n# format\nruff format src/ tests/\n\n# lint\nruff check src/ tests/\n\n# type check\nmypy src/\n```\n",
  "bytes": 2385,
  "sha": "ed93f7ebbd5c2e99289c200aa7cd9daa71ef78c718508340adb1858481fc3a95",
  "repo_slug": "daedalus/mcp-recon-ng",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_recon_ng_da95d6a0/readme"
}