System Tools

Utilities for health checks and self-documentation. The tools_documentation tool is how your AI learns to use all n8n-mcp capabilities.

How AI Self-Discovery Works

Your AI assistant uses tools_documentation to learn about all available tools, their parameters, and best practices. This means you don't need to explain tool syntax — just describe what you want to accomplish.

`n8n_health_check`

Check n8n instance health and API connectivity. Performs comprehensive health check of your n8n instance through its API.

n8n API Key Required

Parameter	Type	Default	Description
`mode`	`string`	`status`	Check mode `statusdiagnostic`
`verbose`	`boolean`	`false`	Extra details in diagnostic mode

Quick health check

javascript

n8n_health_check({})

Detailed diagnostics

javascript

n8n_health_check({mode: "diagnostic", verbose: true})

Use Cases

•Pre-flight checks before deployments
•Continuous monitoring of n8n instance
•Troubleshooting connectivity issues
•Verifying API compatibility

✓Best Practices

•Run health check before deploying workflows
•Use diagnostic mode for troubleshooting
•Check regularly as part of monitoring

`tools_documentation`

The meta-documentation tool that your AI uses to learn how to use all n8n-mcp tools. Returns documentation for any MCP tool, including itself. This is how your AI discovers tool capabilities on its own.

No Setup Required

Parameter	Type	Default	Description
`topic`	`string`	—	Tool name, special topic (javascript_code_node_guide, python_code_node_guide, ai_agents_guide), or "overview"
`depth`	`string`	`essentials`	Documentation depth `essentialsfull`

Get overview of all tools

javascript

tools_documentation()

Learn about a specific tool

javascript

tools_documentation({topic: "search_nodes"})

Get comprehensive details

javascript

tools_documentation({topic: "validate_workflow", depth: "full"})

Code node guides

javascript

tools_documentation({topic: "javascript_code_node_guide"})

AI Agents guide

javascript

tools_documentation({topic: "ai_agents_guide", depth: "full"})

Use Cases

•Learning about available tools
•Getting usage examples for specific tools
•Accessing code node guides
•Understanding AI Agent patterns

✓Best Practices

•Start with overview to understand available tools
•Use depth="full" for comprehensive documentation
•Check guides for code node patterns