tools_documentation

// WHEN AGENTS USE THIS TOOL

AI agents call tools_documentation to retrieve information from N8n without modifying any data. This is common in research, monitoring, and reporting workflows where the agent needs context before taking action. Because read operations don't change state, they are generally safe to allow without restrictions -- but you may still want rate limits to control API costs.

Even though tools_documentation only reads data, uncontrolled read access can leak sensitive information or rack up API costs. An agent caught in a retry loop could make thousands of calls per minute. A rate limit gives you a safety net without blocking legitimate use.

// RECOMMENDED POLICY

Read-only tools are safe to allow by default. No rate limit needed unless you want to control costs.

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

See the full N8n policy for all 20 tools.

// MORE N8N TOOLS

View all 20 tools →

// WHAT CAN GO WRONG

These attack patterns abuse exactly the kind of access tools_documentation gives an agent. Each links to the full case and the policy that stops it:

• Prompt Injection via Tool Results
• Indirect Prompt Injection
• Credential leak via error messages

Browse the full MCP Attack Database →

// OTHER READ TOOLS

Other read tools across the catalogue. The same approach applies to each: allow, with a rate cap to control cost.

// RELATED READING

• Rate Limiting MCP Tool Calls: A Practical Guide
• MCP Security: Why Prompt Guardrails Aren't Enough
• The Case for Deterministic AI Agent Policies
• Why AI Agents Need a Control Plane

// FAQ