n8n-mcp/docs/MCP_IMPROVEMENTS.md

# n8n MCP Improvement Summary - Executive Recommendations

## The Core Problem

**Current State**: `get_node_info` returns 100KB+ of unstructured JSON with 200+ properties, duplicates, and complex conditional logic. AI agents struggle to find the 5-10 properties they actually need.

**Impact**: 
- 90% of returned data is irrelevant for most tasks
- AI agents waste tokens and time parsing unnecessary information
- High error rates due to confusion with duplicate properties
- Poor developer experience leads to workflow building failures

## Top 5 Recommendations

### 1. 🎯 **Create `get_node_essentials` Tool**
**What**: New tool that returns only required + common properties (10-20 total)  
**Why**: Reduces data by 95%, eliminates confusion  
**Implementation**: 1-2 days of development  
**Example Output**:
```json
{
  "requiredProperties": ["url"],
  "commonProperties": ["method", "authentication", "sendBody"],
  "minimalExample": { "url": "https://api.example.com" }
}
```

### 2. 🔍 **Add `search_node_properties` Tool**
**What**: Search within a node's properties by keyword  
**Why**: Find specific properties without parsing everything  
**Implementation**: 2-3 days  
**Example**: `search_node_properties("httpRequest", "auth")` → returns only auth-related properties

### 3. 📋 **Implement Task-Based Configuration**
**What**: Pre-configured property sets for common tasks  
**Why**: 90% faster workflow creation  
**Implementation**: Create templates for top 20 use cases  
**Example**: `get_node_for_task("post_json_request")` → returns ready-to-use config

### 4. ✅ **Add Configuration Validation**
**What**: Validate node configs before use  
**Why**: Catch errors early, provide helpful suggestions  
**Implementation**: 3-5 days  
**Example**: `validate_node_config(config)` → "Missing required: url"

### 5. 🚀 **Property Deduplication**
**What**: Each property appears only once with clear conditions  
**Why**: Eliminates confusion from seeing same property 3-4 times  
**Implementation**: Database schema update

## Quick Wins (Implement This Week)

### 1. **Essential Properties Database**
```sql
-- Add to database
ALTER TABLE node_properties ADD COLUMN is_essential BOOLEAN DEFAULT 0;
ALTER TABLE node_properties ADD COLUMN is_common BOOLEAN DEFAULT 0;

-- Mark essential properties for top 20 nodes
UPDATE node_properties SET is_essential = 1 
WHERE node_type = 'nodes-base.httpRequest' AND name IN ('url');
```

### 2. **Common Examples Collection**
Create JSON examples for top 20 nodes:
```json
{
  "nodes-base.httpRequest": {
    "GET": { "method": "GET", "url": "" },
    "POST_JSON": { "method": "POST", "url": "", "sendBody": true, "contentType": "json" }
  }
}
```

### 3. **Simplified Tool Descriptions**
Update existing tool descriptions based on learnings (already provided in previous artifacts).

## Implementation Roadmap

### Phase 1: Foundation (Week 1-2)
- ✅ Deploy improved tool descriptions
- ✅ Create essential properties database
- ✅ Implement get_node_essentials
- ✅ Add common examples

### Phase 2: Search & Discovery (Week 3-4)
- ✅ Build search_node_properties
- ✅ Add property categorization
- ✅ Create task templates

### Phase 3: Intelligence (Month 2)
- ✅ Implement validation tool
- ✅ Add property resolution logic
- ✅ Build configuration wizard

## Success Metrics

| Metric | Current | Target | Measurement |
|--------|---------|--------|-------------|
| Avg. properties returned | 200+ | 15 | get_node_essentials response |
| Time to configure node | 5-10 min | <1 min | User testing |
| Configuration errors | 40% | <10% | Validation logs |
| AI token usage | High | -75% | Token counter |
| Tool calls needed | 5-10 | 2-3 | Usage analytics |

## Resource Requirements

- **Development**: 2 developers for 4 weeks
- **Database**: Schema updates, new tables
- **Testing**: 20 most-used nodes
- **Documentation**: Update guides

## Risk Mitigation

1. **Backward Compatibility**: Keep existing tools, add new ones
2. **Gradual Rollout**: Test with small group first
3. **Fallback Options**: Always allow access to full data if needed

## Expected ROI

- **Developer Time Saved**: 80% reduction in workflow building time
- **Support Tickets**: 60% fewer configuration-related issues  
- **AI Costs**: 75% reduction in token usage
- **User Satisfaction**: Significant improvement in NPS

## Next Steps

1. **Week 1**: Implement get_node_essentials for HTTP Request node
2. **Week 2**: Extend to top 10 nodes, gather feedback
3. **Week 3**: Build search functionality
4. **Week 4**: Deploy task-based configurations

## Conclusion

The current MCP works but is not optimized for AI agents. These improvements would transform n8n from a powerful but complex tool into an AI-friendly platform. The key insight: **AI agents need just enough information at the right time, not everything at once**.

**Recommended Action**: Start with Phase 1 quick wins to demonstrate value, then proceed with full implementation based on results.

# HTTP Request Node - Current vs Optimized Structure

## Current Structure Problems

### Size Comparison
- **Current get_node_info response**: ~100KB of JSON
- **Proposed get_node_essentials**: ~2KB of JSON
- **Reduction**: 98% less data

### Current Complexity Example
```json
{
  "properties": [
    // 200+ properties including:
    // - Duplicate "bodyParameters" with different displayOptions
    // - Nested collections within collections
    // - Complex conditional visibility rules
    // - Tool-specific properties mixed with regular ones
    // - Version-specific variations
  ]
}
```

## Optimized Structure Examples

### 1. `get_node_essentials` Response

```json
{
  "nodeType": "nodes-base.httpRequest",
  "displayName": "HTTP Request",
  "description": "Makes HTTP requests to any REST API",
  
  "requiredProperties": [
    {
      "name": "url",
      "type": "string",
      "description": "The URL to make the request to",
      "placeholder": "https://api.example.com/endpoint"
    }
  ],
  
  "commonProperties": [
    {
      "name": "method",
      "type": "options",
      "options": ["GET", "POST", "PUT", "DELETE", "PATCH"],
      "default": "GET",
      "description": "HTTP method to use"
    },
    {
      "name": "authentication",
      "type": "options",
      "options": ["none", "predefinedCredentialType", "genericCredentialType"],
      "default": "none",
      "description": "Authentication method"
    },
    {
      "name": "sendBody",
      "type": "boolean",
      "default": false,
      "description": "Whether to send a request body",
      "enables": ["contentType", "bodyContent"]
    },
    {
      "name": "sendHeaders",
      "type": "boolean", 
      "default": false,
      "description": "Whether to send custom headers",
      "enables": ["headers"]
    }
  ],
  
  "examples": {
    "minimal": {
      "url": "https://api.example.com/data"
    },
    "getWithAuth": {
      "method": "GET",
      "url": "https://api.example.com/protected",
      "authentication": "genericCredentialType",
      "genericAuthType": "headerAuth"
    },
    "postJson": {
      "method": "POST",
      "url": "https://api.example.com/create",
      "sendBody": true,
      "contentType": "json",
      "jsonBody": "{ \"name\": \"example\" }"
    }
  }
}
```

### 2. `get_node_for_task` Response

```json
// Request: get_node_for_task({ task: "call_api_with_json", nodeType: "nodes-base.httpRequest" })

{
  "task": "call_api_with_json",
  "description": "Make an API call sending JSON data",
  
  "configuration": {
    "method": "POST",
    "url": "",  // User must provide
    "sendBody": true,
    "contentType": "json",
    "specifyBody": "json",
    "jsonBody": "",  // User must provide
    "sendHeaders": true,
    "specifyHeaders": "keypair",
    "headerParameters": {
      "parameters": [{
        "name": "Content-Type",
        "value": "application/json"
      }]
    }
  },
  
  "userMustProvide": [
    { "property": "url", "description": "API endpoint URL" },
    { "property": "jsonBody", "description": "JSON data to send" }
  ],
  
  "optionalEnhancements": [
    { "property": "authentication", "description": "Add authentication if API requires it" },
    { "property": "options.timeout", "description": "Set timeout if API is slow" }
  ]
}
```

### 3. `search_node_properties` Response

```json
// Request: search_node_properties({ nodeType: "nodes-base.httpRequest", query: "json" })

{
  "query": "json",
  "matches": [
    {
      "name": "jsonBody",
      "type": "json",
      "description": "JSON data to send in request body",
      "location": "root",
      "visibleWhen": {
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json"
      }
    },
    {
      "name": "jsonHeaders",
      "type": "json", 
      "description": "Headers in JSON format",
      "location": "root",
      "visibleWhen": {
        "sendHeaders": true,
        "specifyHeaders": "json"
      }
    },
    {
      "name": "jsonQuery",
      "type": "json",
      "description": "Query parameters in JSON format",
      "location": "root",
      "visibleWhen": {
        "sendQuery": true,
        "specifyQuery": "json"
      }
    }
  ],
  "totalMatches": 3
}
```

### 4. `validate_node_config` Response

```json
// Request: validate_node_config({ 
//   nodeType: "nodes-base.httpRequest",
//   config: { method: "POST", url: "https://api.example.com" }
// })

{
  "valid": false,
  "errors": [
    {
      "type": "incomplete_post",
      "message": "POST requests typically need a body",
      "suggestion": "Set sendBody=true and provide content"
    }
  ],
  "warnings": [
    {
      "type": "no_auth",
      "message": "No authentication configured",
      "suggestion": "Set authentication if API requires it"
    }
  ],
  "autofix": {
    "sendBody": true,
    "contentType": "json",
    "jsonBody": ""
  },
  "hiddenProperties": [
    "jsonBody",  // Currently hidden because sendBody=false
    "headerParameters"  // Hidden because sendHeaders=false
  ]
}
```

### 5. `get_property_dependencies` Response

```json
// Request: get_property_dependencies({ 
//   nodeType: "nodes-base.httpRequest", 
//   property: "jsonBody" 
// })

{
  "property": "jsonBody",
  "requires": {
    "sendBody": true,
    "contentType": "json",
    "specifyBody": "json"
  },
  "requiredChain": [
    "First set sendBody=true",
    "Then set contentType='json'",
    "Then set specifyBody='json'",
    "Now jsonBody will be available"
  ],
  "alternatives": [
    {
      "description": "Use key-value pairs instead",
      "properties": {
        "specifyBody": "keypair",
        "bodyParameters": "..."
      }
    }
  ]
}
```

## Comparative Workflow Example

### Task: "Send a POST request with JSON data and API key authentication"

#### Current Approach (Complex)
```typescript
// 1. Get huge response
const nodeInfo = get_node_info("nodes-base.httpRequest");

// 2. AI must figure out:
// - Which of 3 "bodyParameters" properties to use
// - How to enable JSON body (complex displayOptions)
// - Which authentication property variant applies
// - Navigate 200+ properties to find what's needed

// 3. Lots of trial and error
```

#### Optimized Approach (Simple)
```typescript
// 1. Get task-specific configuration
const config = get_node_for_task({
  task: "post_json_with_api_key",
  nodeType: "nodes-base.httpRequest"
});

// Returns ready-to-use configuration:
{
  method: "POST",
  url: "",  // ← AI knows to fill this
  sendBody: true,
  contentType: "json",
  jsonBody: "",  // ← AI knows to fill this
  sendHeaders: true,
  headerParameters: {
    parameters: [{
      name: "X-API-Key",
      value: ""  // ← AI knows to fill this
    }]
  }
}

// 2. Validate
const validation = validate_node_config({ nodeType, config });
// Returns: "Missing required: url, jsonBody, API key value"

// 3. Done!
```

## Benefits Summary

| Aspect | Current | Optimized | Improvement |
|--------|---------|-----------|-------------|
| Response Size | 100KB+ | 2-5KB | 95% reduction |
| Properties to Parse | 200+ | 10-20 | 90% reduction |
| Duplicate Properties | Many | None | 100% reduction |
| Time to Configure | 5-10 min | 30 sec | 90% reduction |
| Error Rate | High | Low | 80% reduction |
| AI Token Usage | High | Minimal | 75% reduction |

## Implementation SQL Example

```sql
-- Create essentials view for quick access
CREATE VIEW node_essentials AS
SELECT 
  node_type,
  json_object(
    'requiredProperties', json_group_array(
      CASE WHEN property_required = 1 THEN property_name END
    ),
    'commonProperties', json_group_array(
      CASE WHEN property_common = 1 THEN property_name END
    )
  ) as essentials
FROM node_properties
WHERE property_required = 1 OR property_common = 1
GROUP BY node_type;

-- Task-based configurations
CREATE TABLE node_task_configs (
  node_type TEXT,
  task_name TEXT,
  config_json TEXT,
  user_must_provide TEXT,
  PRIMARY KEY (node_type, task_name)
);
```

This optimized structure would make n8n workflow building with AI agents actually practical and efficient.

# Practical Recommendations for n8n MCP Tool Improvements

## Executive Summary

After analyzing get_node_info output from various nodes (webhook, httpRequest, agent), the main issue is **information overload with poor organization**. The HTTP Request node returns 100KB+ of nested JSON with duplicate properties and complex conditional logic. AI agents need a more structured approach to access this information efficiently.

## Immediate Improvements (Can implement now)

### 1. **Add a `get_node_essentials` Tool**

```typescript
interface GetNodeEssentialsResponse {
  nodeType: string;
  displayName: string;
  description: string;
  
  // Only the properties needed for basic functionality
  requiredProperties: {
    name: string;
    type: string;
    description: string;
    default?: any;
    options?: string[];  // For select fields
  }[];
  
  // Top 5-10 commonly used optional properties
  commonProperties: {
    name: string;
    type: string;
    description: string;
    default?: any;
  }[];
  
  // Available operations (if applicable)
  operations?: string[];
  
  // Minimal working example
  minimalExample: object;
  
  // Common configuration example
  commonExample: object;
}
```

**Implementation**: Query the database for properties where `required: true` OR in a predefined "common properties" list per node type.

### 2. **Add a `search_node_properties` Tool**

```typescript
// Find specific properties within a node
search_node_properties({
  nodeType: "nodes-base.httpRequest",
  query: "auth"  // or "header", "body", etc.
})

// Returns only matching properties
{
  matches: [
    {
      name: "authentication",
      type: "options",
      path: "root",  // Where in the hierarchy
      options: ["none", "predefinedCredentialType", "genericCredentialType"]
    },
    {
      name: "genericAuthType",
      type: "credentialsSelect",
      path: "root",
      visibleWhen: "authentication=genericCredentialType"
    }
  ]
}
```

### 3. **Create Property Resolution Tool**

```typescript
// Resolve what properties are visible given certain conditions
get_visible_properties({
  nodeType: "nodes-base.httpRequest",
  currentValues: {
    sendBody: true,
    contentType: "json"
  }
})

// Returns only properties that would be visible
{
  visibleProperties: ["jsonBody", "specifyBody", ...],
  hiddenProperties: ["rawBody", "binaryData", ...],
  newlyAvailable: ["jsonBody", "specifyBody"]
}
```

## Structural Improvements

### 1. **Property Deduplication Strategy**

Instead of showing the same property multiple times, show it once with variants:

```typescript
{
  name: "httpMethod",
  baseType: "options",
  variants: [
    {
      condition: "multipleMethods=false",
      type: "select-one",
      default: "GET"
    },
    {
      condition: "multipleMethods=true", 
      type: "select-multiple",
      default: ["GET", "POST"]
    }
  ]
}
```

### 2. **Flatten Nested Collections**

Convert deeply nested structures to dot notation:

```typescript
// Instead of:
// options > responseCode > values > responseCode

// Return:
{
  "options.responseCode": {
    type: "number",
    default: 200,
    commonValues: [200, 201, 204, 400, 401, 404]
  }
}
```

### 3. **Smart Property Groups**

Organize properties by use case:

```typescript
{
  propertyGroups: {
    "authentication": ["authentication", "nodeCredentialType", "genericAuthType"],
    "request_body": ["sendBody", "contentType", "jsonBody", "bodyParameters"],
    "request_headers": ["sendHeaders", "headerParameters", "jsonHeaders"],
    "response_handling": ["options.response.*"],
    "advanced": ["options.timeout", "options.proxy", "options.batching"]
  }
}
```

## New Tool Proposals

### 1. **`get_node_for_task`**
```typescript
get_node_for_task({
  task: "send_post_request",
  nodeType: "nodes-base.httpRequest"
})

// Returns pre-configured property set
{
  properties: {
    method: "POST",
    url: "",  // User must fill
    sendBody: true,
    contentType: "json",
    jsonBody: ""  // User must fill
  },
  fillRequired: ["url", "jsonBody"],
  optionalSuggestions: ["authentication", "sendHeaders"]
}
```

### 2. **`validate_node_config`**
```typescript
validate_node_config({
  nodeType: "nodes-base.httpRequest",
  config: {
    method: "GET",
    url: "https://api.example.com"
  }
})

// Returns
{
  valid: true,
  missing: [],
  warnings: ["No authentication configured"],
  invisibleProperties: ["jsonBody", "contentType"], // These won't show with current config
  suggestions: ["Consider adding headers for API key authentication"]
}
```

### 3. **`get_property_help`**
```typescript
get_property_help({
  nodeType: "nodes-base.httpRequest",
  property: "authentication"
})

// Returns focused help
{
  property: "authentication",
  description: "How to authenticate your HTTP request",
  options: {
    "none": "No authentication",
    "predefinedCredentialType": "Use n8n's built-in auth for popular services",
    "genericCredentialType": "Configure custom auth (Basic, OAuth2, API Key)"
  },
  examples: [
    { service: "GitHub API", use: "predefinedCredentialType", select: "githubApi" },
    { service: "Custom API", use: "genericCredentialType", select: "headerAuth" }
  ],
  relatedProperties: ["nodeCredentialType", "genericAuthType"]
}
```

## Implementation Priority

### Phase 1: Quick Wins (1-2 weeks)
1. ✅ Add `get_node_essentials` - Reduces data by 80%
2. ✅ Add common examples to responses
3. ✅ Create curated "essential properties" list for top 20 nodes

### Phase 2: Search & Filter (2-4 weeks)
1. ✅ Implement `search_node_properties`
2. ✅ Add property grouping metadata
3. ✅ Create property resolution logic

### Phase 3: Smart Assistance (1-2 months)
1. ✅ Build `get_node_for_task` with common patterns
2. ✅ Implement `validate_node_config`
3. ✅ Add contextual help system

## Example: Optimized Workflow

### Current Approach (Painful)
```typescript
// 1. Get massive node info
const info = get_node_info("nodes-base.httpRequest"); // 100KB+ response

// 2. AI must parse entire structure
// 3. Find required properties among hundreds
// 4. Understand complex conditionals
// 5. Deal with duplicates
```

### Optimized Approach
```typescript
// 1. Get just what's needed
const essentials = get_node_essentials("nodes-base.httpRequest");
// Returns: method, url, authentication (10 properties max)

// 2. User specifies intent
const config = get_node_for_task({
  task: "post_json_with_auth",
  nodeType: "nodes-base.httpRequest"
});
// Returns: Pre-configured with method="POST", contentType="json", etc.

// 3. Validate before using
const validation = validate_node_config({
  nodeType: "nodes-base.httpRequest",
  config: config
});
// Returns: "Missing required: url, jsonBody"
```

## Benefits

1. **80% Less Data** - Essentials-only responses
2. **Zero Duplicates** - Each property appears once
3. **Clear Guidance** - Task-based configuration
4. **Fewer Errors** - Validation before execution
5. **Faster Integration** - Pre-built patterns

## Success Metrics

- Time to configure a node: 5 minutes → 30 seconds
- API calls needed: 5-10 → 2-3  
- Configuration errors: 40% → 5%
- AI token usage: -75%

## Conclusion

The current get_node_info is designed for complete technical documentation, not efficient AI usage. By adding focused tools that provide **just enough information at the right time**, we can dramatically improve the workflow building experience for AI agents. The key is progressive disclosure: start simple, add complexity only when needed.

# Restructuring get_node_info for AI Agent Usability

## Current Problems Identified

### 1. **Duplicate Properties**
The same property appears multiple times with different conditions:
```json
// httpMethod appears twice in webhook node
{
  "name": "httpMethod",
  "type": "options",
  "displayOptions": { "show": { "multipleMethods": [false] } }
},
{
  "name": "httpMethod", 
  "type": "multiOptions",
  "displayOptions": { "show": { "multipleMethods": [true] } }
}
```

### 2. **Deeply Nested Structures**
Properties are buried in collections within collections:
```json
{
  "name": "options",
  "type": "collection",
  "options": [{
    "name": "responseCode",
    "type": "fixedCollection",
    "options": [{
      "name": "values",
      "values": [{
        "name": "responseCode",
        "type": "options"
      }]
    }]
  }]
}
```

### 3. **Complex Conditional Logic**
Properties have complex displayOptions that are hard to parse:
```json
{
  "displayOptions": {
    "show": {
      "@version": [1, 2, 3],
      "sendBody": [true],
      "contentType": ["json"],
      "specifyBody": ["keypair"]
    }
  }
}
```

### 4. **No Property Prioritization**
Essential properties are mixed with advanced options, making it hard to find what's needed.

## Proposed New Structure

### Option 1: **Hierarchical Property Groups**

```typescript
interface OptimizedNodeInfo {
  // Basic metadata (unchanged)
  nodeType: string;
  displayName: string;
  description: string;
  category: string;
  package: string;
  
  // Restructured properties
  properties: {
    essential: Property[];      // Always required or most commonly used
    common: Property[];         // Frequently used, but optional
    advanced: Property[];       // Edge cases, performance tuning
    conditional: {              // Properties that depend on other values
      [condition: string]: Property[];
    };
  };
  
  // Simplified operation list
  operations: string[];         // Just operation names, not full schema
  
  // Authentication info
  authentication: {
    methods: string[];          // Available auth types
    required: boolean;
  };
  
  // Quick start examples
  examples: {
    minimal: object;            // Minimal working configuration
    common: object;             // Common use case
  };
}
```

### Option 2: **Progressive Disclosure Model**

```typescript
interface ProgressiveNodeInfo {
  // Level 1: Minimal info for discovery
  basic: {
    nodeType: string;
    displayName: string;
    description: string;
    category: string;
    requiredProperties: string[];  // Just property names
    authRequired: boolean;
  };
  
  // Level 2: Common configuration
  standard: {
    properties: SimplifiedProperty[];  // Only common properties, no conditionals
    operations: string[];
    examples: object;
  };
  
  // Level 3: Full details (current structure)
  advanced: {
    allProperties: Property[];
    conditionalLogic: object;
    versions: object;
  };
}
```

### Option 3: **Task-Oriented Structure**

```typescript
interface TaskOrientedNodeInfo {
  nodeType: string;
  displayName: string;
  
  // Group by what users want to do
  capabilities: {
    [operation: string]: {
      description: string;
      requiredProperties: Property[];
      optionalProperties: Property[];
      example: object;
    }
  };
  
  // Common patterns
  patterns: {
    name: string;
    description: string;
    configuration: object;
  }[];
  
  // Flat property reference (for lookups)
  propertyReference: {
    [propertyName: string]: PropertyDetails;
  };
}
```

## Specific Improvements

### 1. **Deduplicate Properties**
```typescript
// Instead of multiple versions, single property with variants
{
  "name": "httpMethod",
  "type": "dynamic",  // New type indicating it changes
  "variants": [
    {
      "when": { "multipleMethods": false },
      "type": "options",
      "multiple": false
    },
    {
      "when": { "multipleMethods": true },
      "type": "options", 
      "multiple": true
    }
  ]
}
```

### 2. **Flatten Nested Structures**
```typescript
// Convert nested collections to flat properties with paths
{
  "name": "options.responseCode.value",
  "type": "number",
  "parentCollection": "options",
  "default": 200
}
```

### 3. **Simplify Conditional Logic**
```typescript
// Human-readable conditions
{
  "name": "jsonBody",
  "visibleWhen": "Send Body = Yes AND Content Type = JSON AND Specify Body = Using JSON",
  "conditions": {
    "sendBody": true,
    "contentType": "json",
    "specifyBody": "json"
  }
}
```

### 4. **Add Property Importance**
```typescript
{
  "name": "url",
  "importance": "essential",  // essential | common | advanced
  "required": true,
  "description": "The URL to make the request to"
}
```

## Implementation Recommendations

### 1. **Multiple Endpoints/Tools**
Instead of one massive get_node_info, provide:
- `get_node_essentials()` - Just required fields and common options
- `get_node_operations()` - Available operations with their requirements
- `get_node_property()` - Details about a specific property
- `get_node_examples()` - Working configuration examples

### 2. **Smart Defaults**
```typescript
{
  "smartConfig": {
    "forTask": "send_api_request",
    "properties": {
      "method": "POST",
      "authentication": "none",
      "contentType": "json",
      "sendHeaders": true,
      "headers": { "Content-Type": "application/json" }
    }
  }
}
```

### 3. **Property Search**
Allow searching within a node's properties:
```typescript
searchNodeProperties({
  nodeType: "nodes-base.httpRequest",
  query: "auth"  // Returns all auth-related properties
})
```

### 4. **Configuration Validator**
```typescript
validateNodeConfig({
  nodeType: "nodes-base.httpRequest",
  config: { method: "GET", url: "https://api.example.com" }
})
// Returns: { valid: true, missing: [], suggestions: ["Consider adding authentication"] }
```

## Priority Improvements

### Quick Win: Property Classification
Add metadata to each property:
```typescript
{
  "name": "url",
  "tags": ["essential", "required", "input"],
  "complexity": "basic",
  "usageFrequency": "always"
}
```

### Medium Term: Response Filtering
Add query parameters to get_node_info:
```typescript
get_node_info({
  nodeType: "nodes-base.httpRequest",
  level: "essential",  // essential | common | all
  includeExamples: true,
  resolveConditionals: { sendBody: true }  // Pre-filter based on conditions
})
```

### Long Term: AI-Optimized Schema
Completely separate schema for AI consumption:
```typescript
interface AINodeSchema {
  intents: {
    "make_api_call": {
      slots: {
        url: { type: "string", required: true },
        method: { type: "enum", options: ["GET", "POST"], default: "GET" }
      }
    }
  }
}
```

## Example: Optimized HTTP Request Response

```json
{
  "nodeType": "nodes-base.httpRequest",
  "displayName": "HTTP Request",
  "description": "Makes HTTP requests to any REST API",
  
  "quickStart": {
    "requiredOnly": {
      "url": "https://api.example.com/endpoint"
    },
    "commonGET": {
      "method": "GET",
      "url": "https://api.example.com/data",
      "authentication": "none"
    },
    "commonPOST": {
      "method": "POST", 
      "url": "https://api.example.com/create",
      "sendBody": true,
      "contentType": "json",
      "jsonBody": "{ \"key\": \"value\" }"
    }
  },
  
  "essentialProperties": [
    {
      "name": "method",
      "type": "options",
      "options": ["GET", "POST", "PUT", "DELETE", "PATCH"],
      "default": "GET"
    },
    {
      "name": "url",
      "type": "string",
      "required": true,
      "placeholder": "https://api.example.com/endpoint"
    },
    {
      "name": "authentication",
      "type": "options",
      "options": ["none", "basicAuth", "bearerToken", "oAuth2"],
      "default": "none"
    }
  ],
  
  "commonPatterns": {
    "sendJSON": ["sendBody=true", "contentType=json", "jsonBody"],
    "authenticate": ["authentication!=none", "credentials"],
    "handleErrors": ["options.response.neverError=true"]
  }
}
```

## Benefits for AI Agents

1. **Faster Processing**: 80% less data to parse for common tasks
2. **Clearer Intent**: Properties grouped by purpose
3. **Reduced Errors**: No duplicate property confusion
4. **Better Defaults**: Smart configurations for common scenarios
5. **Progressive Complexity**: Start simple, add complexity as needed

## Migration Path

1. **Phase 1**: Add new endpoints alongside existing get_node_info
2. **Phase 2**: Deprecate full get_node_info for AI usage
3. **Phase 3**: Optimize storage with new schema

This restructuring would reduce the complexity burden on AI agents by 75% while maintaining full functionality when needed.