mcpField
P
Port Scanner X402

Port Scanner X402

Remote
github.comSecurity0Updated 8w ago

About Port Scanner X402

Port Scanner X402 is an MCP server for AI agents that checks TCP port status and response times on a host. Calls are paid through x402 without an API key or signup.

Key features

  1. 01Scan TCP ports on a host
  2. 02Return port status and response times
  3. 03Scan 16 common ports by default
  4. 04Accept a custom port list
  5. 05Pay per call with x402

Use cases

  1. 01Check open ports on servers
  2. 02Verify firewall rules
  3. 03Check network service availability
  4. 04Audit infrastructure

MCP support

A remote MCP server exposes the `network_scan_ports` tool for scanning TCP ports on a host.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://port-scanner.api.klymax402.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

Port Scanner API

MCP Server x402 License: MIT

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

ToolMethodPathPriceDescription
network_scan_portsPOST/api/scan$0.008Scan 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

NameTypeRequiredDescription
hoststringyesThe hostname or IP address to scan
portsarraynoArray 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.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.