list_refs

What list_refs does on Enhanced Knowledge Graph Memory Server

AI agents call list_refs to retrieve information from Enhanced Knowledge Graph Memory Server without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why list_refs is rated Low

This is a query operation that returns information about registered references in the RefIndex. It has no side effects, does not modify any data, and does not trigger external operations. The optional filtering parameter is a read-only constraint on the output. This is a standard Read category tool with low severity since it only exposes existing data without the ability to modify or destroy it.

From the tool's definition Tool name 'list_refs' and description 'List all registered refs in the RefIndex, optionally filtered by entity name' - purely retrieves/queries data with optional filtering. No modification, deletion, or execution occurs.

The rule that runs list_refs safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Enhanced Knowledge Graph Memory Server, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For list_refs, this is the rule to start with:

{
  "version": "1",
  "default": "deny",
  "tools": {
    "list_refs": {}
  }
}

Questions about list_refs