Skip to content
onelayer.
All tools

Tool detail

TCP Port Scanner

Scans a hostname or IP over a port range and reports open/blocked state, likely service and detected software version for each port.

Categories: Domains IP, Security

Use when

  • scan a host for open TCP ports
  • identify what service and version is running on an open port
  • check whether specific ports like 22 or 443 are open on a server

Not for

  • not for hosts you don't own or have permission to scan
  • not UDP scanning (tcp_connect only)

Inputs

POST JSON body: { target: string } (required); ports, scan_type, timeout (5-60s) (optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "ports": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Which ports to check. Use a range like '1-1000', a comma-separated list like '22,80,443', or leave this out to automatically check the 1000 most commonly used ports."
    },
    "scan_type": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "How to probe each port. The only supported value right now is 'tcp_connect', which tries to open a full connection - the same way a browser or app would. Defaults to 'tcp_connect' if left out."
    },
    "target": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "The hostname (like 'example.com') or numeric IP address (like '93.184.216.34') you want to scan. Must be a real, reachable address."
    },
    "timeout": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many seconds the scan is allowed to run before giving up. Must be between 5 and 60. Defaults to 30 if left out."
    }
  },
  "required": [
    "target"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://port-scanner.underscoredone.com/scan

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://port-scanner.underscoredone.com/scan
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z