{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_x4hcdwtp2nce","handle":"network-mcp","url":"https://wellknown.network/agents/network-mcp","links":{"self":"https://wellknown.network/agents/network-mcp/record.json","html":"https://wellknown.network/agents/network-mcp","markdown":"https://wellknown.network/agents/network-mcp/record.md","api":"https://wellknown.network/api/v1/agents/network-mcp","status":"https://wellknown.network/api/v1/agents/network-mcp/status","claim":"https://wellknown.network/agents/network-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/network-mcp/claim.json","badge":"https://wellknown.network/agents/network-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/network-mcp/history","tools":"https://wellknown.network/api/v1/agents/network-mcp/tools"},"ard":{"identifier":"urn:air::server:network-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"network-mcp","summary":"Network MCP Server for AI Agents - Connectivity testing and pcap analysis","description":"# Network MCP Server\n\nA Model Context Protocol (MCP) server providing network diagnostic tools for AI agents. Designed to offload heavy network analysis to the server and return structured, actionable data optimized for LLM consumption.\n\n[![PyPI version](https://img.shields.io/pypi/v/network-mcp.svg)](https://pypi.org/project/network-mcp/)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/labeveryday/network-mcp/main/docs/architecture.png\" alt=\"Network MCP Architecture\" width=\"800\"/>\n</p>\n\n## Features\n\n- **Connectivity Testing**: ping, traceroute, DNS lookups, port checks, MTR\n- **Batch Operations**: Test multiple hosts/ports concurrently\n- **Local Network Info**: Get interfaces, routes, DNS config, ARP table, connections (cross-platform)\n- **Pcap Analysis**: Analyze packet captures with scapy (no tshark required)\n- **Custom Filters**: Execute scapy filter expressions for advanced queries (AST-validated)\n- **Security Controls**: Configurable allowlist/blocklist for target validation (enforced on connectivity tools)\n- **PCAP Path Guardrails**: Restrict which directories the server is allowed to read captures from\n- **Smart Summaries**: Returns human-readable summaries plus structured data\n\n## Installation\n\n```bash\npip install network-mcp\n```\n\nOr install from source:\n\n```bash\ngit clone https://github.com/labeveryday/network-mcp.git\ncd network-mcp\npip install -e .\n```\n\n## Quick Start\n\nRun the MCP server:\n\n```bash\nnetwork-mcp\n```\n\nOr with Python:\n\n```bash\npython -m network_mcp.server\n```\n\nRecommended first run (helps agents decide what’s safe/available on this host):\n\n- **Check capabilities**: call `capabilities` to see installed binaries (like `mtr`), active security policy, and PCAP path guardrails.\n- **Decide on policy**: if you need to loos…","publisher":{"name":"Du'An Lightfoot","url":null},"homepage":"https://github.com/labeveryday/network-mcp","repository":"https://github.com/labeveryday/network-mcp","version":"0.1.2","license":"MIT License  Copyright (c) 2025 Du'An Lightfoot  Permission is …","protocols":["mcp"],"tags":["dns","mcp","mtr","netops","network","networking","observability","pcap","ping","scapy","traceroute"],"pricing":null,"endpoints":[{"url":"pypi:network-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"network-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:23.395Z","publishedAt":"2025-12-20T01:03:09.947253Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"network-mcp","url":"https://pypi.org/project/network-mcp/","firstSeenAt":"2026-09-10T08:24:59.157Z","fetchedAt":"2026-11-03T20:27:10.291Z","normalizedAt":"2026-11-03T20:27:10.291Z"}]},"firstSeenAt":"2026-09-10T08:24:59.157Z","updatedAt":"2026-11-03T20:29:23.395Z"}