n8n MCP Server

Instructions

Implementation Reference

• src/index.ts:657-678 (handler)

  The main handler function for the 'get_node_type' MCP tool. It calls the N8nClient to fetch the node type by name and returns it as JSON or an error if not found.

  private async handleGetNodeType(args: { type: string }) {
    const nodeType = await this.n8nClient.getNodeTypeByName(args.type);
    if (!nodeType) {
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(jsonError(`Node type '${args.type}' not found. Use list_node_types to see available types.`, 'NOT_FOUND'), null, 2),
          },
        ],
      };
    }
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(jsonSuccess(nodeType), null, 2),
        },
      ],
    };
  }

• src/index.ts:110-123 (schema)

  The input schema and metadata for the 'get_node_type' tool, defining the expected 'type' parameter.

  {
    name: 'get_node_type',
    description: 'Get details about a specific n8n node type',
    inputSchema: {
      type: 'object',
      properties: {
        type: {
          type: 'string',
          description: 'The node type name (e.g., n8n-nodes-base.httpRequest)',
        },
      },
      required: ['type'],
    },
  },

• src/index.ts:253-254 (registration)

  The switch case registration that routes CallTool requests for 'get_node_type' to the handler method.

  case 'get_node_type':
    return await this.handleGetNodeType(request.params.arguments as { type: string });

• src/n8n-client.ts:286-291 (helper)

  Helper method in N8nClient that delegates to node-registry's getNodeType.

  async getNodeTypeByName(typeName: string): Promise<N8nNodeType | null> {
    // Try to get from n8n API first (if available in future)
    // For now, use curated catalog
    const nodeType = getNodeType(typeName);
    return nodeType || null;
  }

• src/node-registry.ts:393-395 (helper)

  Core lookup function that retrieves node type definition from the static NODE_CATALOG.

  export function getNodeType(typeName: string): N8nNodeType | undefined {
    return NODE_CATALOG[typeName];
  }