NodeZero MCP
This Integration is part of the NodeZero MCP Pack.#
Use the NodeZero MCP integration to connect to the NodeZero MCP server and automatically discover its available pentesting tools.
This integration uses OAuth 2.0 Dynamic Client Registration (DCR). It registers itself as a public OAuth client with the NodeZero OAuth proxy, so no pre-issued Client ID or Client Secret is required. Authentication flows through the NodeZero portal.
Configure NodeZero MCP in Cortex#
| Parameter | Description | Required |
|---|---|---|
| MCP Server URL | The NodeZero MCP server endpoint. Select the region that matches your NodeZero deployment. | True |
| Authorization Code | The authorization code that the !nodezero-mcp-generate-login-url command returns. Paste it here, and then run !nodezero-mcp-auth-test to complete the authentication. |
Commands#
You can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
list-tools#
Retrieves a list of available tools on the NodeZero MCP server.
Base Command#
list-tools
Input#
| Argument Name | Description | Required |
|---|
Context Output#
There is no context output for this command.
call-tool#
Calls a specific tool on the NodeZero MCP server with optional input parameters.
Base Command#
call-tool
Input#
| Argument Name | Description | Required |
|---|---|---|
| name | The name of the tool to call. | Optional |
| arguments | The parameters for the tool execution. | Optional |
Context Output#
There is no context output for this command.
nodezero-mcp-generate-login-url#
Registers this integration with your NodeZero portal and generates a login URL. To authenticate through the NodeZero portal, follow the instructions that the command returns.
Base Command#
nodezero-mcp-generate-login-url
Input#
There are no input arguments for this command.
Context Output#
There is no context output for this command.
Command example#
!nodezero-mcp-generate-login-url
Human Readable Output#
Authorization instructions#
Click on the login URL to sign in and grant Cortex permissions for your MCP server. You will be automatically redirected to a link with the following structure:
REDIRECT_URI?code=AUTH_CODE&session_state=SESSION_STATECopy the
AUTH_CODE(without thecode=prefix, and thesession_stateparameter) and paste it in the instance configuration under the Authorization code parameter.Save the instance configuration. IMPORTANT NOTE: Authentication code is time-sensitive and expires quickly. Please copy the Authorization code to the instance configuration within a short time frame after generating the login URL.
To check connectivity, run the !nodezero-mcp-auth-test command.
nodezero-mcp-auth-test#
Tests the OAuth authentication configuration with the NodeZero MCP server.
Base Command#
nodezero-mcp-auth-test
Input#
There are no input arguments for this command.
Context Output#
There is no context output for this command.
Command example#
!nodezero-mcp-auth-test
Human Readable Output#
โ Authentication successful.