The Networking plugin provides essential network diagnostic and connectivity tools that Agents can use to troubleshoot network issues, test connectivity, and gather information about network infrastructure.

Configuration

Configure the Networking plugin by editing the ~/.unpage/profiles/<profile_name>/config.yaml file:
plugins:
  # ...
  networking:
    enabled: true

Tools

The Networking plugin provides the following tools to Agents and MCP Clients:

ping

Ping a host and return connectivity statistics.Arguments
host
string
required
The hostname or IP address to ping. Can be a domain name (e.g., “google.com”) or IP address (e.g., “8.8.8.8”).
Returns string: Detailed ping results including packet transmission statistics, response times, and packet loss percentage in standard ping output format.

dig

Resolve a hostname using DNS lookup and return the records.Arguments
hostname
string
required
The hostname to resolve (e.g., “example.com”).
record_type
string
The DNS record type to query (default: “A”). Common types include A, AAAA, CNAME, MX, TXT, NS, SOA.
Returns string: DNS resolution results showing the requested records, or an error message if the hostname cannot be resolved.

traceroute

Trace the network path to a destination showing all intermediate hops.Arguments
destination
string
required
The target hostname or IP address to trace the route to.
max_hops
integer
Maximum number of hops to trace (default: 30). Higher values allow tracing longer network paths.
Returns string: Step-by-step trace showing each network hop from your location to the destination, including IP addresses and response times.

request_url

Make an HTTP GET request to a URL and return the response content.
We don’t do anything to restrict which urls may be requested here. Be careful about how this gets exposed within and outside of your organization, as it could become an SSRF target.
Arguments
url
string
required
The full URL to request (e.g., “https://example.com/api/status”). Must include the protocol (http:// or https://).
Returns string: The HTTP response body content. Raises an error if the request fails or returns a non-success status code.