network_port_scan
Probe a live host for open TCP ports using TCP connect scanning. Returns port status (open, closed, filtered) and service detection. Only scan systems you own or have permission to test.
Instructions
TCP Connect Port Scanner. Probe a live host for open TCP ports by opening real outbound TCP connections from this server to each requested port and reporting which answer (open), refuse (closed), or time out (filtered). Use this to detect actually-listening services on a host you control; use network_tcp_udp_port_reference instead for offline lookup of what a port number conventionally means (no live probe). Makes outbound network connections from the server, resolves the host and pins the scan to the first publicly-routable IP (private and reserved ranges are rejected), is a TCP connect scan the target may log, and is heavily rate-limited (1 per minute, 5 per hour, 20 per day anonymous) with CAPTCHA and terms acceptance. Only scan systems you own or have permission to test. Returns per-port status with detected service name and response time, plus open/closed/filtered summary counts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Target hostname or IP address to scan. Must resolve to a publicly-routable address (private and reserved IPs are rejected). | |
| ports | No | Comma-separated ports and ranges (for example 80,443,8080 or 1-1024). Each port must be 1-65535; at most 100 distinct ports after expansion or the request is rejected. | 22,23,25,53,80,110,143,443,993,995 |
| timeout | No | Per-port TCP connect timeout in seconds. Values outside 1-30 are coerced to 3. | |
| worker_id | No | Optional registered healthy worker peer ID. Omit to use the default master-server behavior. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | Whether the scan completed. | |
| host | No | The submitted target host, echoed back. | |
| target_ip | No | The resolved publicly-routable IP the scan was pinned to. | |
| ports_scanned | No | Number of ports probed. | |
| timeout | No | Per-port timeout in seconds actually used. | |
| results | No | One entry per scanned port. | |
| summary | No | Aggregate counts across all probed ports. | |
| warnings | No | Advisory notices about logging, authorization, and rate limits. | |
| timestamp | No | ISO 8601 completion time. |