Skip to content
MCP server

NetsCLI

Network scanner for AI agents: host discovery, port scans, DNS, ARP and mDNS lookups

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.3.4
Listing updated
1 day ago

About NetsCLI

NetsCLI is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

NetsCLI is a Rust network scanner with a command line, terminal UI, desktop app and this MCP server, all built on one library. By default the server exposes nine tools and returns structured results, so an agent can ask which device joined the network or whether port 22 is open on a host instead of parsing human-oriented output. Packet-capture builds add four more tools, but the npm package leaves capture out because it needs libpcap or Npcap.

Scanning is restricted to your own networks unless you set NETSCLI_MCP_ALLOW_PUBLIC_TARGETS, which is off by default. The server speaks JSON-RPC over stdio and can be run from an installed binary, via npx, or as an .mcpb bundle that carries its own binary. Installing the binary is preferred, since packet capture then works and the version is the one you chose.

The project is MIT licensed, with installers for macOS, Linux and Windows.

Install

Run in a terminal

claude mcp add netscli -- npx -y netscli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "netscli": {
      "command": "npx",
      "args": [
        "-y",
        "netscli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "netscli": {
      "command": "npx",
      "args": [
        "-y",
        "netscli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "netscli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "netscli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "netscli": {
      "command": "npx",
      "args": [
        "-y",
        "netscli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "netscli": {
      "command": "npx",
      "args": [
        "-y",
        "netscli"
      ]
    }
  }
}

Configuration

  • NETSCLI_MCP_ALLOW_PUBLIC_TARGETSSet to 1 to allow targets outside your own networks. Off by default.

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

discover_network
Discover reachable hosts on a subnet
scan_ports
Scan TCP ports or UDP services on a host
ping_host
Check reachability and latency
dns_lookup
Query DNS records
get_arp_table
Read the local ARP cache
inspect_host
Build a host profile
sweep_network
Discover hosts and scan selected ports
list_network_interfaces
List local network interfaces
discover_mdns
Discover mDNS and DNS-SD services
capture_pcap
Capture packets in one blocking call
start_pcap_capture
Start a packet capture job
get_pcap_capture_status
Poll a capture job
get_pcap_capture_result
Fetch a completed capture

What it does

Host discovery
Find reachable hosts on a subnet and sweep selected ports.
TCP and UDP scanning
Return open ports, with closed ones on request.
DNS, ARP and mDNS
Query records, read the ARP cache and discover local services.
Host inspection
Combine reachability, DNS, MAC vendor, OS hint and ports.
Local-only default
Scanning beyond your own networks must be explicitly enabled.
Optional packet capture
Capture-enabled builds add pcap tools.

Good for

  • Ask which device just joined the home network
  • Check whether a port is open on a server you manage
  • Inventory local mDNS services
  • Get structured scan output into scripts or agents

Pricing

Open source

Free and open source, MIT

Prices change. Check netscli.com before you buy.

NetsCLI FAQ

Can it scan public hosts?

Not by default. Setting NETSCLI_MCP_ALLOW_PUBLIC_TARGETS to 1 allows targets outside your own networks.

Does it need installing?

No. You can run it with npx, but installing the binary is preferred and enables packet capture.

How many tools are there?

Nine by default, plus four with packet-capture support.

What licence?

MIT.

Is NetsCLI free?

Yes. NetsCLI is open source, so you can use and self-host it for free.

How do I add NetsCLI to Claude Code?

Run this command in your terminal: claude mcp add netscli -- npx -y netscli

What are the best alternatives to NetsCLI?

The closest alternatives to NetsCLI are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to NetsCLI

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools