Skip to main content
Glama
subnet-calculator-mcp

subnet-calculator-mcp

Subnet Calculator MCP Server

CI PyPI Downloads subnet-calculator-mcp is a production-ready Model Context Protocol server that delivers reliable IPv4 subnet planning utilities to LLM-powered assistants. It eliminates tedious manual math by exposing fast, well-tested tools for subnet sizing, wildcard mask generation, gateway selection, and host validation.

Why Use This Server?

  • 🔢 Convert host requirements into accurate subnet masks and CIDR prefixes

  • 🌐 Produce Cisco-friendly OSPF wildcard masks and network statements

  • ✅ Verify whether an IP belongs to a subnet, including gateway hints and address position

  • 🔄 Reverse-calculations from dotted masks or find the Nth usable address instantly

  • ⚙️ Built on the official Python MCP SDK with thorough type hints, validation, and tests

Related MCP server: NetworkCalc MCP Server

Install & Run

The package is published on PyPI: https://pypi.org/project/subnet-calculator-mcp/

Install with pip

pip install subnet-calculator-mcp
python -m subnet_calculator_mcp.server

Run instantly (no install)

uvx subnet-calculator-mcp

Install as a reusable CLI

uv tool install subnet-calculator-mcp
# later
subnet-calculator-mcp

Client Configuration

Claude Desktop / Claude for Windows

Add the server to claude_desktop_config.json.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "subnet-calculator": {
      "command": "uvx",
      "args": ["subnet-calculator-mcp"]
    }
  }
}

If you installed via uv tool install or pip, change the command to "subnet-calculator-mcp" and omit args.

Generic mcp.json

Many editors (Cursor, Windsurf, etc.) use an mcp.json file. Add the following entry:

{
  "subnet-calculator": {
    "command": "uvx",
    "args": ["subnet-calculator-mcp"],
    "env": {}
  }
}

Set command to "subnet-calculator-mcp" if the binary is installed globally.

Tool Reference

calculate_subnet

  • Inputs: network_base (IPv4 address), hosts_needed (int), optional return_format ("detailed" or "simple").

  • Returns: CIDR prefix, dotted mask, wildcard mask, usable range, broadcast, binary representations, total/usable host counts.

  • Use it for: deriving the smallest subnet that can host the requested number of usable addresses.

calculate_wildcard_mask

  • Inputs: ip_address (any IP in the subnet), cidr_prefix (0–32), optional include_ospf_command (bool).

  • Returns: network address, mask, wildcard mask, binary wildcard string, and optional network ... area 0 statement.

  • Use it for: creating OSPF configurations or ACLs that rely on wildcard masks.

validate_ip_in_subnet

  • Inputs: ip_address, network (CIDR string), optional return_gateway (bool).

  • Returns: membership flag, mask, prefix, network/broadcast flags, usability, likely gateway, position index, and remaining usable addresses.

  • Use it for: quickly verifying assignments and identifying first-hop router addresses.

calculate_subnet_from_mask

  • Inputs: ip_address, subnet_mask (dotted decimal).

  • Returns: network boundary, prefix, wildcard mask, usable range, broadcast, and host counts.

  • Use it for: analysing legacy configurations that provide dotted masks instead of CIDR notation.

get_nth_usable_ip

  • Inputs: network (CIDR string), position (1-based index).

  • Returns: IP address at that position, whether it is last usable, total usable hosts, and associated network address.

  • Use it for: allocating deterministic host positions (first server, second router, etc.).

Example invocation:

{
  "tool": "calculate_subnet",
  "arguments": {
    "network_base": "172.16.0.16",
    "hosts_needed": 14
  }
}

Development Workflow

git clone https://github.com/sanjayshreeyans/subnet-calculator-mcp.git
cd subnet-calculator-mcp

# Install dependencies (dev group includes pytest, mypy, ruff, black)
uv sync --group dev

# Run the automated test suite
uv run pytest

# Type-check, lint, and format
uv run mypy src
uv run ruff check src tests
uv run black --check src tests

# Build distribution artifacts
uv build

License

MIT License – see LICENSE for details.

Available Tools

5 tools
calculate_subnetC

Calculate subnet details given a base IP and required hosts.

Inputs: network_base (required), hosts_needed (required), return_format.

calculate_subnet_from_maskC

Calculate network information from an IP address and subnet mask.

Inputs: ip_address (required), subnet_mask (required).

calculate_wildcard_maskB

Generate OSPF wildcard mask details for a subnet.

Inputs: ip_address (required), cidr_prefix (required), include_ospf_command.

get_nth_usable_ipC

Return the Nth usable IP address in a subnet.

Inputs: network (required), position (required).

validate_ip_in_subnetC

Validate that an IP address belongs to a subnet and provide context.

Inputs: ip_address (required), network (required), return_gateway.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: calculate_subnet and calculate_subnet_from_mask differ by input type, calculate_wildcard_mask is specific, get_nth_usable_ip retrieves a specific IP, and validate_ip_in_subnet checks membership. No ambiguity.

    Naming Consistency5/5

    All tools use a consistent verb_noun pattern with snake_case: calculate_subnet, calculate_subnet_from_mask, calculate_wildcard_mask, get_nth_usable_ip, validate_ip_in_subnet. The verbs 'calculate', 'get', and 'validate' are clear and predictable.

    Tool Count5/5

    With 5 tools, the server is well-scoped for a subnet calculator. Each tool serves a necessary function without redundancy or bloat.

    Completeness4/5

    The set covers core subnet operations (calculation from hosts/mask, wildcard, nth IP, validation). Minor gaps exist, such as no explicit tool for listing all usable IPs or calculating total hosts, but core workflows are supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables subnet mask calculations and network planning through MCP framework. Provides detailed subnet information including network addresses, IP ranges, and broadcast addresses, plus LAN planning advice for different network scales.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides network utility tools including DNS lookup, WHOIS lookup, SPF record inspection, SSL/TLS certificate checking, and subnet/CIDR analysis powered by networkcalc.com services.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides accurate IPv4 subnet and address tools for LLMs using Python's ipaddress library. Includes CIDR parsing, overlap detection, IP classification, and more.
      11
      GPL 3.0