list_folders

What list_folders does on AirMCP

AI agents call list_folders to retrieve information from AirMCP without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why list_folders is rated Low

This is a read-only query that enumerates folder structures and provides metadata (note counts). It has no side effects, does not modify data, and does not execute code or trigger external operations. The blast radius of misuse is minimal — an agent would only gain visibility into folder organization and note counts, which is informational only.

From the tool's definition Tool name 'list_folders' and description 'List all folders across all accounts with note counts' — performs a retrieval operation with no modification, deletion, or execution of external operations.

The rule that runs list_folders safely

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

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

Questions about list_folders