
Mcp Pymetasploit3
This server wraps pymetasploit3 to expose Metasploit Framework operations through the msfrpc protocol. It connects to msfrpcd or msfconsole's RPC service and gives you tools for module management, session handling, console interaction, and database queries. You can list exploits, set options, execute modules, interact with sessions, and search the framework. Reach for it when you need programmatic access to Metasploit's full toolkit without dropping into msfconsole directly. It requires a running Metasploit RPC server on port 55553 by default. The server handles everything from payload generation to workspace management and credential enumeration.
- GitHub stars
- 1
- tools
- 46
- transport
- STDIO
- last updated
- Apr 6, 2026
Tools
46 toolsPublic tool metadata for what this MCP can expose to an agent.
connectConnect to Metasploit RPC server
Connect to Metasploit RPC server
No parameter schema in public metadata yet.
disconnectDisconnect from RPC server
Disconnect from RPC server
No parameter schema in public metadata yet.
get_client_infoGet current connection status
Get current connection status
No parameter schema in public metadata yet.
list_modulesList available modules by type
List available modules by type
No parameter schema in public metadata yet.
use_moduleLoad a specific module
Load a specific module
No parameter schema in public metadata yet.
get_module_infoGet module description and info
Get module description and info
No parameter schema in public metadata yet.
get_module_optionsGet all module options
Get all module options
No parameter schema in public metadata yet.
set_module_optionSet a module option
Set a module option
No parameter schema in public metadata yet.
get_missing_requiredGet required options not set
Get required options not set
No parameter schema in public metadata yet.
execute_moduleExecute a module
Execute a module
No parameter schema in public metadata yet.
get_module_targetsGet available targets
Get available targets
No parameter schema in public metadata yet.
set_module_targetSet the target
Set the target
No parameter schema in public metadata yet.
get_target_payloadsGet compatible payloads
Get compatible payloads
No parameter schema in public metadata yet.
generate_payloadGenerate a payload
Generate a payload
No parameter schema in public metadata yet.
list_sessionsList all active sessions
List all active sessions
No parameter schema in public metadata yet.
get_session_infoGet session information
Get session information
No parameter schema in public metadata yet.
interact_sessionWrite/read from session
Write/read from session
No parameter schema in public metadata yet.
session_run_commandRun command with output
Run command with output
No parameter schema in public metadata yet.
stop_sessionStop a session
Stop a session
No parameter schema in public metadata yet.
create_consoleCreate a new console
Create a new console
No parameter schema in public metadata yet.
destroy_consoleDestroy a console
Destroy a console
No parameter schema in public metadata yet.
write_consoleWrite to console
Write to console
No parameter schema in public metadata yet.
read_consoleRead console output
Read console output
No parameter schema in public metadata yet.
console_is_busyCheck if console is busy
Check if console is busy
No parameter schema in public metadata yet.
run_module_outputExecute module and get output
Execute module and get output
No parameter schema in public metadata yet.
get_framework_versionGet framework version
Get framework version
No parameter schema in public metadata yet.
core_saveSave core state
Save core state
No parameter schema in public metadata yet.
core_reload_modulesReload modules
Reload modules
No parameter schema in public metadata yet.
core_set_globalSet global variable
Set global variable
No parameter schema in public metadata yet.
core_unset_globalUnset global variable
Unset global variable
No parameter schema in public metadata yet.
get_db_statusGet database status
Get database status
No parameter schema in public metadata yet.
db_list_workspacesList workspaces
List workspaces
No parameter schema in public metadata yet.
db_set_workspaceSet current workspace
Set current workspace
No parameter schema in public metadata yet.
db_list_hostsList hosts
List hosts
No parameter schema in public metadata yet.
db_list_servicesList services
List services
No parameter schema in public metadata yet.
db_list_notesList notes
List notes
No parameter schema in public metadata yet.
db_list_credsList credentials
List credentials
No parameter schema in public metadata yet.
db_list_vulnsList vulnerabilities
List vulnerabilities
No parameter schema in public metadata yet.
list_jobsList running jobs
List running jobs
No parameter schema in public metadata yet.
stop_jobStop a job
Stop a job
No parameter schema in public metadata yet.
get_job_infoGet job information
Get job information
No parameter schema in public metadata yet.
list_pluginsList loaded plugins
List loaded plugins
No parameter schema in public metadata yet.
load_pluginLoad a plugin
Load a plugin
No parameter schema in public metadata yet.
unload_pluginUnload a plugin
Unload a plugin
No parameter schema in public metadata yet.
search_modulesSearch for modules
Search for modules
No parameter schema in public metadata yet.
get_module_referencesGet module references
Get module references
No parameter schema in public metadata yet.
Sponsors
Readme
mcp-pymetasploit3
MCP server for Metasploit Framework via pymetasploit3. This server exposes all pymetasploit3 functionality as MCP tools, allowing LLMs to interact with Metasploit Framework through the msfrpc protocol.
Install
pip install mcp-pymetasploit3
MCP Server Configuration
{
"mcpServers": {
"mcp-pymetasploit3": {
"command": "mcp-pymetasploit3",
"env": {}
}
}
}
Usage
Starting Metasploit RPC Server
Before using the MCP server, you need to start the Metasploit RPC server:
Using msfrpcd:
msfrpcd -P yourpassword -p 55553 -n
Using msfconsole:
msfconsole -q
msf6 > load msgrpc Pass=yourpassword
MCP Tools
Once connected, the following tools are available:
Connection Management
connect- Connect to Metasploit RPC serverdisconnect- Disconnect from RPC serverget_client_info- Get current connection status
Details
- Repository
- github.com/daedalus/mcp-pymetasploit3
- Category
- Security & Pentesting
- Package
mcp-pymetasploit3- Transport
- STDIO
- Registry
- MCP registry, active