Skip to content
MCP server

whatismynetip

Subnet math, port, MAC, DNS and TLS lookups for network work in your agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About whatismynetip

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

This server packages the toolbox behind whatismynetip.com so an agent can call it directly. Most tools never touch the network: subnet calculation for IPv4 and IPv6 (including /31 and /32), address-in-block tests, IPv4 conversion between dotted, integer, hex and binary, and IPv6 normalisation. The MAC lookup uses a bundled copy of the IEEE registry, roughly 40,000 assignments.

The port lookup covers 100 hand-written ports, each with a verdict on whether to expose it; RDP on 3389 is marked never to expose to the internet. DNS, reverse DNS and blocklist checks go over DNS-over-HTTPS, and TLS inspection connects directly to the host you name while refusing anything that resolves to private or reserved space.

It is free, MIT licensed and sends no telemetry. A check that your own port is reachable from outside needs a machine beyond your NAT, which the website's port checker handles and this local server cannot.

Install

Run in a terminal

claude mcp add netip-mcp -- docker run -i --rm ghcr.io/getlarkwright/netip-mcp:0.1.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "netip-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netip-mcp:0.1.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "netip-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netip-mcp:0.1.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "netip-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netip-mcp:0.1.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "netip-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netip-mcp:0.1.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "netip-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netip-mcp:0.1.1"
      ]
    }
  }
}

Tools this server provides (11)

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

subnet_calc
Network, mask, wildcard, broadcast, host range and counts for a CIDR.
ip_in_subnet
Whether an address falls inside a block.
ip_convert
Convert an IPv4 address between dotted, integer, hex and binary.
ipv6_normalize
Expanded and compressed forms of an IPv6 address.
mac_lookup
Vendor and address bits for a MAC.
lookup_port
What runs on a port and whether to expose it.
dns_lookup
DNS records over DNS-over-HTTPS.
reverse_dns
PTR lookup for an IP.
dnsbl_check
Check five common blocklists.
tls_inspect
Inspect the certificate a host serves.
my_public_ip
The public address, location, ASN and reverse DNS.

What it does

Subnet calculator
Network, mask, wildcard, broadcast and host range for any CIDR.
Bundled MAC vendors
Looks up vendors offline from the IEEE registry.
Opinionated port notes
Each of 100 ports carries a verdict on internet exposure.
DNS and blocklists
Queries records, reverse DNS and five common blocklists over DoH.
TLS inspection
Shows the certificate a host serves: expiry, SANs, chain and cipher.
Public IP view
Reports edge location, ASN, reverse DNS and a datacenter or VPN hint.

Good for

  • Work out host ranges while planning a VLAN layout
  • Decide whether a port should ever face the internet
  • Check a domain's certificate expiry and SANs
  • See if an IP appears on common spam blocklists
  • Identify the vendor behind a MAC address

Pricing

Open source

Free, MIT licence

Prices change. Check whatismynetip.com before you buy.

whatismynetip FAQ

Which tools use the network?

The DNS, reverse DNS, blocklist, TLS and public IP tools; the subnet, conversion, MAC and port tools run locally.

Can it stop me scanning my own network with tls_inspect?

It refuses any host that resolves to private or reserved address space.

Does it collect data?

No. The README states no account, no key and no telemetry.

Can it test whether my port is open from outside?

No; that needs an outside machine, which the site's port checker provides.

Is whatismynetip free?

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

How do I add whatismynetip to Claude Code?

Run this command in your terminal: claude mcp add netip-mcp -- docker run -i --rm ghcr.io/getlarkwright/netip-mcp:0.1.1

What are the best alternatives to whatismynetip?

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

Alternatives to whatismynetip

  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