MCP Tools

Available tools

The MCP server exposes 18 tools that map to Intruder API endpoints. Your AI agent calls these automatically based on your natural language prompts so you don't need to reference them directly.

API health

ToolDescription
get_userReturns the email address of the authenticated API user
get_statusReturns the current status of the Intruder API

Targets

ToolDescriptionKey parameters
list_targetsLists all targets with their IDs, addresses, and status (live, license_exceeded, unscanned, unresponsive, agent_uninstalled)
create_targetsAdds one or more targets to your accountaddresses — list of target addresses (e.g. ['example.com', 'test.com'])
delete_targetRemoves a target from your accounttarget_id

Tags

ToolDescriptionKey parameters
list_tagsLists all tags in your account, optionally filtered by targettarget_address (optional)
create_target_tagAdds a tag to a target (max 40 characters)target_id, name
delete_target_tagRemoves a tag from a targettarget_id, tag_name

Scans

ToolDescriptionKey parameters
list_scansLists scans with optional filtersstatus (optional) — in_progress, completed, cancelled, cancelled_no_active_targets, cancelled_no_valid_targets, analysing_results; scan_type (optional) — assessment_schedule, new_service, cloudbot_new_target, rapid_remediation, advisory, cloud_security
create_scanStarts a scan on specified targets or tagged targetstarget_addresses (optional), tag_names (optional)
get_scanRetrieves full details of a specific scan, including status, timestamps, and target listscan_id
cancel_scanCancels a running scanscan_id

Issues & occurrences

ToolDescriptionKey parameters
list_issuesLists issues with optional filterstarget_addresses (optional), tag_names (optional), snoozed (optional), severity (optional) — critical, high, medium, low
list_occurrencesLists all occurrences for a specific issueissue_id, plus optional filters: target_addresses, tag_names, snoozed
get_scanner_outputRetrieves raw scanner output for an occurrence, including plugin details, CVEs, and scan evidenceissue_id, occurrence_id
snooze_issueSnoozes an issue and all its current and future occurrencesissue_id, reason (ACCEPT_RISK, FALSE_POSITIVE, MITIGATING_CONTROLS), plus optional details, duration, duration_type
snooze_occurrenceSnoozes a specific occurrence of an issueissue_id, occurrence_id, reason (ACCEPT_RISK, FALSE_POSITIVE, MITIGATING_CONTROLS), plus optional details, duration, duration_type

Licenses

ToolDescription
list_licensesShows infrastructure and application license totals, available counts, and consumed counts. Licenses are tied to a target for 30 days once used.

Scan types explained

When listing or filtering scans, the scan_type parameter corresponds to how the scan was triggered:

Scan typeWhat it means
assessment_scheduleScans that run on a regular schedule
new_serviceTriggered when a new service is exposed on a target
cloudbot_new_targetTriggered when CloudBot discovers a new target in a connected cloud account
rapid_remediationUser-triggered scan to test if a specific issue has been remediated
advisoryAn issue created by the Intruder security team based on their manual work
cloud_securityScans of cloud accounts, checking the configuration of the resources in the cloud account