# whatismynetip

> whatismynetip is an open-source MCP server for developer tools. Subnet math, port, MAC, DNS and TLS lookups for network work in your agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://whatismynetip.com
- **Repository:** https://github.com/getlarkwright/netip-mcp
- **MCP Registry name:** io.github.getlarkwright/netip-mcp
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/whatismynetip
