network_tcp_udp_port_reference
Look up TCP and UDP port assignments from a built-in database of well-known and registered network services. Filter by service name, protocol, numeric range, or category to identify port numbers.
Instructions
TCP/UDP Port Reference Lookup. Look up TCP and UDP port assignments from a built-in static database of well-known and registered network services (HTTP, HTTPS, SSH, FTP, DNS, SMTP, databases, VPNs, games, and more). Filter by free-text query, protocol, numeric range, or service category and get matching port records with service name, description, and any security note. Use this for offline port-number and service identification; use network_port_scanner instead to probe a live host for actually-open ports. Read-only, non-destructive, contacts no external service (queries an in-memory table), and rate-limited (30 req/min, 180/hr anonymous). Returns the full match list, a limit-capped display slice, and TCP/UDP and range summary counts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | Yes | Free-text query matched against port number, service name, description, and category (case-insensitive substring). The special form "tcp:443" or "udp:53" matches one exact protocol+port. Empty string returns all ports (subject to the other filters). | |
| protocol | No | Restrict results to one transport protocol. all returns both TCP and UDP. Case-insensitive. | all |
| range | No | Restrict by port range: well-known 0-1023, registered 1024-49151, dynamic 49152-65535, or all. | all |
| category | No | Restrict to one service category, or all for every category. | all |
| limit | No | Maximum number of records returned in displayedPorts. Non-positive or non-numeric values fall back to 50. Does not cap total or ports. | |
| 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 | True when the lookup succeeded. | |
| search | No | Normalised (trimmed) search query that was applied. | |
| protocol | No | Normalised (lowercased) protocol filter that was applied. | |
| range | No | Range filter that was applied. | |
| category | No | Category filter that was applied. | |
| total | No | Total number of port records matching the filters (before the limit slice). | |
| ports | No | All matching port records, sorted by port number then protocol. | |
| displayedPorts | No | First limit records of ports, for paginated display. | |
| stats | No | Aggregate counts over the matched ports. | |
| error | No | Error message when success is false. |