The Graph plugin provides tools for exploring and navigating the Knowledge Graph, allowing Agents to search for resources, understand their relationships, and discover the overall topology of your infrastructure.

​
Configuration

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

​
Tools

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

get_resource_topology

Get a map of the types of resources and how they’re connected.Arguments NoneReturns string: A DOT graph representation showing resource types and their relationship patterns.

search_resources

Find resources with an identifier matching the given identifier or regular expression.Arguments
​
identifier_or_regex
string
required
The identifier to search for, or a regular expression surrounded by slashes (e.g., /^my-resource-\d+$/). If no exact match is found, the tool will perform fuzzy matching on partial identifiers.
Returns list[string] or string: List of node IDs that match the search criteria, or a message if no resources are found.Note: Results are limited to 500 items. Use get_resource_details with the returned node IDs to get full resource information.

get_resource_details

Get the full details of a resource from its node ID.Arguments
​
node_id
string
required
The unique node identifier of the resource. Typically obtained from search_resources or other graph tools.
Returns dict: Complete resource details including all metadata and properties from the original data source.

get_resource_map

Get a detailed map of a resource and its dependencies.Arguments
​
root_node_id
string
required
The node ID of the resource to use as the starting point for the map.
​
max_depth
integer
Maximum depth to traverse from the root node (default: 2). Higher values include more distant relationships but may return very large maps.
Returns string: A DOT graph representation showing the resource and all its connected resources up to the specified depth.Note: This is an excellent first tool for understanding a specific part of your system architecture.

get_neighboring_resources

Get the IDs of resources directly connected to the specified resource.Arguments
​
node_id
string
required
The unique node identifier of the resource whose neighbors you want to find.
​
max_depth
integer
Maximum depth to traverse for neighbors (default: 1). Use 1 for immediate neighbors only.
Returns list[string]: List of node IDs for neighboring resources.