Port Check

Check if services are responding on given host:port pairs. Supports TCP and HTTP checks with configurable timeout. Use for service monitoring, health checks, and network debugging.

modbender Updated 12 repo stars

File contents

Port Check Skill

Quickly verify if services are up and responding on specific ports.

Usage

# Basic TCP check
bash scripts/port-check.sh localhost:8080 localhost:5432

# Multiple targets with HTTP status check
bash scripts/port-check.sh localhost:80 api.example.com:443 --http

# Custom timeout (default 3s)
bash scripts/port-check.sh 192.168.1.1:22 --timeout 5

Output

  • ✅ host:port — open (TCP connected)
  • ✅ host:port — open (HTTP 200) (with --http flag)
  • ⚠️ host:port — open but HTTP 500 (port open, bad HTTP status)
  • ❌ host:port — closed/timeout (no response)

Exit Codes

  • 0 — all targets up
  • 1 — one or more targets down

Common Checks

# OpenClaw gateway
bash scripts/port-check.sh localhost:18789 --http

# Database + web stack
bash scripts/port-check.sh localhost:5432 localhost:6379 localhost:3000

# Home network devices
bash scripts/port-check.sh 192.168.1.1:80 192.168.1.50:22 --timeout 2

modbender/skill-library-mcp/tree/main/data/port-check commit cab8c1aad3

Frequently asked questions

npx skillmds@latest add modbender/port-check