About
Check open TCP ports on any host.
README
Scan TCP ports on any host -- check open/closed status, response time. 16 common ports by default. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"port-scanner": {
"url": "https://port-scanner.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl -X POST "https://port-scanner.api.klymax402.com/api/scan" \
-H "Content-Type: application/json" \
-d '{"host":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
network_scan_ports |
POST | /api/scan |
$0.008 | Scan common ports on a host to check which are open |
network_scan_ports
Use this when you need to check which TCP ports are open on a host. Returns port status and response times in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
host |
string | yes | The hostname or IP address to scan |
ports |
array | no | Array of port numbers to scan (default: [21,22,25,53,80,110,143,443,993,995,3306,3389,5432,6379,8080,8443]) |
Example response:
{"host":"example.com","ports":[{"port":80,"status":"open","responseTime":45},{"port":443,"status":"open","responseTime":52},{"port":22,"status":"closed","responseTime":null}],"openCount":2,"totalScanned":16,"scanDuration":1200}
When to use: server reconnaissance, verifying firewall rules, checking service availability, and infrastructure auditing.
Not for: DNS resolution (use network_lookup_dns), SSL certificate checks (use security_check_ssl), HTTP header analysis (use network_analyze_headers).
Example agent prompts
- "Check which TCP ports are open on a host"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Installing Port Scanner
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/br0ski777/port-scanner-x402FAQ
Is Port Scanner MCP free?
Yes, Port Scanner MCP is free — one-click install via Unyly at no cost.
Does Port Scanner need an API key?
No, Port Scanner runs without API keys or environment variables.
Is Port Scanner hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Port Scanner in Claude Desktop, Claude Code or Cursor?
Open Port Scanner on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare Port Scanner with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
