nwtools-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nwtools-mcp Check if 10.0.0.5 is in 10.0.0.0/24"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
nwtools-mcp
An MCP server that gives LLMs accurate IPv4 subnet and address tools. LLMs are unreliable at network math — this server provides deterministic, correct results via Python's ipaddress standard library.
PyPI: https://pypi.org/project/nwtools-mcp/
Tools
Tool | Description |
| Network address, broadcast, netmask, wildcard mask, host count |
| Check whether an IP falls within a subnet |
| Detect overlap between two subnets and return the intersection |
| Convert a CIDR to its first and last IP address |
| Convert an IP range to the minimal list of covering CIDRs |
| Carve a subnet out of a larger block, returning remaining CIDRs |
| Find unallocated space within a container block |
| Check whether a set of CIDRs fully covers a target block |
| Collapse a list of CIDRs into the minimal set of supernets |
| Classify an IP as RFC 1918, loopback, link-local, multicast, or public |
| Convert an IP between dotted-decimal, hex, binary, and integer |
Related MCP server: subnet-calculator-mcp
Environment variables
Variable | Default | Description |
|
|
|
|
| Bind address (HTTP transports only) |
|
| Listen port (HTTP transports only) |
| (none) | When set, requires |
|
| Python log level for process and request logging |
Local use (stdio)
The stdio transport is used when Claude Desktop spawns the server as a subprocess. No network port is opened.
Run from PyPI with uvx
The simplest way to run the server locally is:
uvx nwtools-mcpThat runs the nwtools-mcp console command from an isolated ephemeral environment. For a persistent install:
uv tool install nwtools-mcp
nwtools-mcpInstall and run directly:
pip install -e .
python main.pyOr use the console script:
nwtools-mcpOr install from PyPI with pip:
pip install nwtools-mcp
nwtools-mcpOr via Docker:
docker run --rm -i nwtools-mcpClaude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"nwtools": {
"command": "python",
"args": ["/path/to/nwtools-mcp/main.py"]
}
}
}Or run it directly from PyPI with uvx:
{
"mcpServers": {
"nwtools": {
"command": "uvx",
"args": ["nwtools-mcp"]
}
}
}If you prefer a persistent uv-managed install, use:
{
"mcpServers": {
"nwtools": {
"command": "nwtools-mcp"
}
}
}Remote deployment (HTTP)
The server supports streamable-http (recommended) and sse transports for remote access. Set MCP_TRANSPORT to switch modes.
Running the HTTP server
# Local test
MCP_TRANSPORT=streamable-http python main.py
# With auth
API_KEY=your-secret MCP_TRANSPORT=streamable-http python main.pyWith Docker:
docker build -t nwtools-mcp .
docker run --rm -p 8000:8000 \
-e MCP_TRANSPORT=streamable-http \
-e API_KEY=your-secret \
nwtools-mcpOperational endpoints
When running in HTTP mode, the container exposes two unauthenticated probe endpoints:
Endpoint | Description |
| Basic liveness probe |
| Readiness probe |
HTTP requests are also logged as structured JSON lines, including method, path, status, duration, client IP, and request ID.
TLS and auth
The server does not terminate TLS. In production, place it behind a reverse proxy. Example Caddy config:
nwtools.example.com {
reverse_proxy localhost:8000
}The built-in API_KEY check adds a layer of defense at the application level, but it does not replace TLS — never expose the server without it.
Connecting Claude to a remote server
In Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"nwtools": {
"url": "https://nwtools.example.com/mcp",
"headers": {
"X-API-Key": "your-secret"
}
}
}
}On claude.ai, add the server under Settings → Integrations using the same URL.
Development
Install with the test extra and run the suite:
pip install -e ".[test]"
pytestTo build distribution artifacts locally:
uv buildOr with the standard Python build frontend:
pip install build
python -m buildRelease
The project is now structured to publish cleanly to PyPI and run via uvx.
Build locally:
uv buildPublish manually:
uv publishAutomated publishing uses publish.yml with PyPI Trusted Publishing.
Release checklist:
Update
versionin pyproject.toml and__version__in src/nwtools_mcp/init.py.Run
pytest.Run
uv build.Commit and push to
main.Push a version tag such as
v0.2.0.
Trusted Publisher settings:
Create a
pypienvironment in the GitHub repository settings.Add a Trusted Publisher for this project on PyPI that matches:
Repository owner:crims0nRepository name:nwtools-mcpWorkflow filename:publish.ymlEnvironment name:pypi
The publish workflow builds the wheel and sdist, smoke-tests both artifacts, and then runs uv publish.
Requirements
Python 3.11+
uvicorn
Available Tools
11 toolscheck_coverageC
Check whether a set of CIDRs fully covers a target block.
Inputs: target_cidr (required), covering_cidrs (required).
cidr_to_rangeC
Convert a CIDR block to its first and last IP address.
Inputs: cidr (required).
classify_ipC
Classify an IPv4 address by its scope and allocation type.
Inputs: ip (required).
find_gapsC
Find unallocated address space within a container block.
Inputs: container_cidr (required), used_cidrs (required).
ip_convertA
Convert an IPv4 address between dotted-decimal, hex, binary, and integer forms.
Inputs: ip (required).
ip_in_subnetC
Check whether an IPv4 address falls within a subnet.
Inputs: ip (required), cidr (required).
parse_cidrC
Parse a CIDR block and return key network properties.
Inputs: cidr (required).
range_to_cidrsA
Convert an inclusive IP address range to the minimal list of covering CIDRs.
Inputs: first_ip (required), last_ip (required).
subnets_overlapB
Check whether two IPv4 subnets overlap.
Inputs: cidr_a (required), cidr_b (required).
subtract_subnetC
Subtract one subnet from another and return the remaining address space as CIDRs.
Inputs: base_cidr (required), remove_cidr (required).
summarize_cidrsA
Collapse a list of CIDRs into the minimal set of covering supernets.
Inputs: cidrs (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose, from parsing CIDRs (parse_cidr) to checking coverage (check_coverage) and finding gaps (find_gaps). There is no ambiguity or overlap between tool functionalities.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., classify_ip, summarize_cidrs, subtract_subnet), making the set predictable and easy to navigate.
With 11 tools, the server is well-scoped for IP address manipulation tasks. Each tool earns its place, covering essential operations without unnecessary bloat or missing coverage.
The tool set covers the full lifecycle of common IP networking tasks: parsing, conversion, classification, membership checking, coverage analysis, gap detection, overlap checking, subtraction, summarization, and range conversion. No obvious gaps for the domain.
Maintenance
Related MCP Connectors
Open-source IP address and CIDR tools for network calculations and public IP lookup.
Calculates IPv4 subnet information from an IP address and CIDR prefix or dotted decimal subnet mask
Inspect IPv4/IPv6 subnets, allocate labeled prefixes and detect overlaps with exact address counts.
IP geolocation, ASN and network data, plus VPN, proxy and Tor detection. ASN tools need no key.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides verified IPv4 subnet calculations, IP analysis, and network diagram generation for AI tutoring systems via MCP.2MIT
- AlicenseBqualityDmaintenanceEnables IPv4 subnet planning and validation, including CIDR prefix calculation, wildcard mask generation, and host position lookup for network engineers.51MIT
- AlicenseAqualityDmaintenanceProvides tools to classify, test, and expand IPv4/IPv6 addresses using Node's built-in net module.36 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides IP address utilities including parsing and classification of IPv4/IPv6 addresses and CIDR block information.88 npmMIT