Files
n8n-mcp/src/mcp/tool-docs/workflow_management/n8n-get-workflow-details.ts
czlonkowski c1a6347d4f feat: complete modular documentation system for all MCP tools (#60)
- Migrated all 40 MCP tools documentation to modular structure
- Created comprehensive documentation with both essentials and full details
- Organized tools by category: discovery, configuration, validation, templates, workflow_management, system, special
- Fixed all TODO placeholders with informative, precise content
- Each tool now has concise description, key tips, and full documentation
- Improved documentation quality: 30-40% more concise while maintaining usefulness
- Fixed TypeScript compilation issues and removed orphaned content
- All tools accessible via tools_documentation MCP endpoint
- Build successful with zero errors

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-17 21:35:00 +02:00

49 lines
2.2 KiB
TypeScript

import { ToolDocumentation } from '../types';
export const n8nGetWorkflowDetailsDoc: ToolDocumentation = {
name: 'n8n_get_workflow_details',
category: 'workflow_management',
essentials: {
description: 'Get workflow details with metadata, version, execution stats. More info than get_workflow.',
keyParameters: ['id'],
example: 'n8n_get_workflow_details({id: "workflow_123"})',
performance: 'Fast (100-300ms)',
tips: [
'Includes execution statistics',
'Shows version history info',
'Contains metadata like tags'
]
},
full: {
description: 'Retrieves comprehensive workflow details including metadata, execution statistics, version information, and usage analytics. Provides more information than get_workflow, including data not typically needed for editing but useful for monitoring and analysis.',
parameters: {
id: { type: 'string', required: true, description: 'Workflow ID to retrieve details for' }
},
returns: 'Extended workflow object with: id, name, nodes, connections, settings, plus metadata (tags, owner, shared users), execution stats (success/error counts, average runtime), version info, created/updated timestamps',
examples: [
'n8n_get_workflow_details({id: "abc123"}) - Get workflow with stats',
'const details = n8n_get_workflow_details({id: "xyz789"}); // Analyze performance'
],
useCases: [
'Monitor workflow performance',
'Analyze execution patterns',
'View workflow metadata',
'Check version information',
'Audit workflow usage'
],
performance: 'Slightly slower than get_workflow due to additional metadata - typically 100-300ms. Stats may be cached.',
bestPractices: [
'Use for monitoring and analysis',
'Check execution stats before optimization',
'Review error counts for debugging',
'Monitor average execution times'
],
pitfalls: [
'Requires N8N_API_URL and N8N_API_KEY configured',
'More data than needed for simple edits',
'Stats may have slight delay',
'Not all n8n versions support all fields'
],
relatedTools: ['n8n_get_workflow', 'n8n_list_executions', 'n8n_get_execution', 'n8n_list_workflows']
}
};